# apache/thrift architecture

> Architecture diagram of the GitHub repository apache/thrift, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/apache/thrift
- Repository: https://github.com/apache/thrift

## Overview

Apache Thrift is a language-independent RPC stack. Its main workflow takes a Thrift IDL through parsing and code generation to language-specific client and server code, which uses transports, protocols, and processors to make remote calls. The graph also preserves the runtime abstractions and language implementations described by the README. Most runtime links are documented at the architectural level; sampled source excerpts are limited, so component-level runtime wiring is not asserted beyond that documentation.

Main entry points: [`lib`](https://github.com/apache/thrift/tree/master/lib) (Language Libraries), [`compiler/cpp/src/thrift/main.cc`](https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/main.cc) (Compiler CLI), [`compiler/cpp/src/thrift/parse/parse.cc`](https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/parse/parse.cc) (IDL Parser), [`compiler/cpp/src/thrift/generate/t_generator_registry.h`](https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/generate/t_generator_registry.h) (Generator Registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_compiler["Compiler"]
  node_idl["Thrift IDL"]
  node_compiler_cli["Compiler CLI<br/>[main.cc]"]
  node_parser["IDL Parser<br/>[parse.cc]"]
  node_program_model["Program Model<br/>[t_program.h]"]
  node_generator_registry["Generator Registry"]
  node_generators["Language Generators"]
end

subgraph group_bindings["Generated Bindings"]
  node_generated_code["Generated Code"]
end

subgraph group_runtime["RPC Runtime"]
  node_rpc_client["RPC Client"]
  node_protocol["Serialization Protocol"]
  node_transport["Data Transport"]
  node_server["RPC Server"]
  node_processor["Application Processor"]
  node_service_handler["Service Handler"]
end

subgraph group_languages["Language Libraries"]
  node_language_libraries["Language Libraries"]
  node_cpp_runtime["C++ Runtime"]
  node_go_runtime["Go Runtime"]
  node_java_runtime["Java Runtime"]
  node_netstd_runtime[".NET Runtime"]
  node_c_glib_runtime["C GLib Runtime"]
end

node_idl_author(("IDL Author"))
node_remote_peer(("Remote Peer"))

node_idl_author -->|"defines services"| node_idl
node_idl -->|"compile input"| node_compiler_cli
node_compiler_cli -.->|"parses IDL"| node_parser
node_parser -.->|"builds model"| node_program_model
node_compiler_cli -.->|"selects generator"| node_generator_registry
node_generator_registry -.->|"dispatches to"| node_generators
node_generators -->|"generates bindings"| node_generated_code
node_generated_code -->|"implements calls"| node_rpc_client
node_rpc_client -->|"serializes calls"| node_protocol
node_protocol -->|"encodes data"| node_transport
node_transport -->|"sends data"| node_remote_peer
node_remote_peer -->|"initiates request"| node_server
node_server -->|"receives data"| node_transport
node_server -->|"dispatches request"| node_processor
node_processor -->|"decodes request"| node_protocol
node_processor -->|"invokes service"| node_service_handler
node_service_handler -->|"returns result"| node_processor
node_language_libraries -->|"includes"| node_cpp_runtime
node_language_libraries -->|"includes"| node_go_runtime
node_language_libraries -->|"includes"| node_java_runtime
node_language_libraries -->|"includes"| node_netstd_runtime
node_language_libraries -->|"includes"| node_c_glib_runtime
node_cpp_runtime -->|"provides runtime"| node_rpc_client
node_go_runtime -->|"provides runtime"| node_rpc_client
node_java_runtime -->|"provides runtime"| node_rpc_client
node_netstd_runtime -->|"provides runtime"| node_rpc_client
node_c_glib_runtime -->|"provides runtime"| node_rpc_client

click node_compiler_cli "https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/main.cc"
click node_parser "https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/parse/parse.cc"
click node_program_model "https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/parse/t_program.h"
click node_generator_registry "https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/generate/t_generator_registry.h"
click node_generators "https://github.com/apache/thrift/tree/master/compiler/cpp/src/thrift/generate"
click node_language_libraries "https://github.com/apache/thrift/tree/master/lib"
click node_cpp_runtime "https://github.com/apache/thrift/tree/master/lib/cpp/src/thrift"
click node_go_runtime "https://github.com/apache/thrift/tree/master/lib/go/thrift"
click node_java_runtime "https://github.com/apache/thrift/tree/master/lib/java/src/main/java/org/apache/thrift"
click node_netstd_runtime "https://github.com/apache/thrift/tree/master/lib/netstd/Thrift"
click node_c_glib_runtime "https://github.com/apache/thrift/tree/master/lib/c_glib/src/thrift/c_glib"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_idl,node_compiler_cli,node_parser,node_program_model,node_generator_registry,node_generators toneBlue
class node_generated_code toneAmber
class node_rpc_client,node_protocol,node_transport,node_server,node_processor,node_service_handler toneMint
class node_language_libraries,node_cpp_runtime,node_go_runtime,node_java_runtime,node_netstd_runtime,node_c_glib_runtime toneRose
class node_idl_author,node_remote_peer toneIndigo
```

## Components

### Compiler

- **Thrift IDL**
- [Compiler CLI](https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/main.cc): `compiler/cpp/src/thrift/main.cc`
- [IDL Parser](https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/parse/parse.cc): `compiler/cpp/src/thrift/parse/parse.cc`
- [Program Model](https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/parse/t_program.h): `compiler/cpp/src/thrift/parse/t_program.h`
- [Generator Registry](https://github.com/apache/thrift/blob/master/compiler/cpp/src/thrift/generate/t_generator_registry.h): `compiler/cpp/src/thrift/generate/t_generator_registry.h`
- [Language Generators](https://github.com/apache/thrift/tree/master/compiler/cpp/src/thrift/generate): `compiler/cpp/src/thrift/generate`

### Generated Bindings

- **Generated Code**

### RPC Runtime

- **RPC Client**
- **Serialization Protocol**
- **Data Transport**
- **RPC Server**
- **Application Processor**
- **Service Handler**

### Language Libraries

- [Language Libraries](https://github.com/apache/thrift/tree/master/lib): `lib`
- [C++ Runtime](https://github.com/apache/thrift/tree/master/lib/cpp/src/thrift): `lib/cpp/src/thrift`
- [Go Runtime](https://github.com/apache/thrift/tree/master/lib/go/thrift): `lib/go/thrift`
- [Java Runtime](https://github.com/apache/thrift/tree/master/lib/java/src/main/java/org/apache/thrift): `lib/java/src/main/java/org/apache/thrift`
- [.NET Runtime](https://github.com/apache/thrift/tree/master/lib/netstd/Thrift): `lib/netstd/Thrift`
- [C GLib Runtime](https://github.com/apache/thrift/tree/master/lib/c_glib/src/thrift/c_glib): `lib/c_glib/src/thrift/c_glib`

### Other components

- **IDL Author**
- **Remote Peer**

## Connections

- IDL Author → Thrift IDL: defines services (evidence: `README.md`)
- Thrift IDL → Compiler CLI: compile input (evidence: `README.md`)
- Compiler CLI → IDL Parser: parses IDL
- IDL Parser → Program Model: builds model
- Compiler CLI → Generator Registry: selects generator
- Generator Registry → Language Generators: dispatches to (evidence: `compiler/cpp/src/thrift/generate/t_generator.h`)
- Language Generators → Generated Code: generates bindings (evidence: `README.md`)
- Generated Code → RPC Client: implements calls (evidence: `README.md`)
- RPC Client → Serialization Protocol: serializes calls (evidence: `README.md`)
- Serialization Protocol → Data Transport: encodes data (evidence: `README.md`)
- Data Transport → Remote Peer: sends data (evidence: `README.md`)
- Remote Peer → RPC Server: initiates request (evidence: `README.md`)
- RPC Server → Data Transport: receives data (evidence: `README.md`)
- RPC Server → Application Processor: dispatches request (evidence: `README.md`)
- Application Processor → Serialization Protocol: decodes request (evidence: `README.md`)
- Application Processor → Service Handler: invokes service (evidence: `README.md`)
- Service Handler → Application Processor: returns result (evidence: `README.md`)
- Language Libraries → C++ Runtime: includes (evidence: `README.md`)
- Language Libraries → Go Runtime: includes (evidence: `README.md`)
- Language Libraries → Java Runtime: includes (evidence: `README.md`)
- Language Libraries → .NET Runtime: includes (evidence: `README.md`)
- Language Libraries → C GLib Runtime: includes (evidence: `README.md`)
- C++ Runtime → RPC Client: provides runtime (evidence: `README.md`)
- Go Runtime → RPC Client: provides runtime (evidence: `README.md`)
- Java Runtime → RPC Client: provides runtime (evidence: `README.md`)
- .NET Runtime → RPC Client: provides runtime (evidence: `README.md`)
- C GLib Runtime → RPC Client: provides runtime (evidence: `README.md`)
