trpc-gen-python

Generate type-safe Python clients from tRPC routers. Automatically converts your tRPC endpoints into Pydantic models and httpx-based client code.

Installation

npx trpc-gen-python generate

Or install globally:

npm install -g trpc-gen-python
trpc-gen-python generate

Quick Start

1. Create a trpc-gen-python.toml configuration file in your project root:

# Which endpoints to generate (supports glob patterns)
endpoints = ["user.*", "post.list"]

[router]
# Path to your tRPC router file
path = "./src/server/router.ts"
# Export name of your router
export = "appRouter"
# Base URL for your tRPC API
base_url = "http://localhost:3000/api/trpc"

[output]
# Output directory for generated Python code
dir = "./generated"
# Name of the generated Python package
package_name = "trpc_client"

2. Run the generator:

npx trpc-gen-python generate

3. Use the generated Python client:

from generated.trpc_client import TRPCClient

client = TRPCClient()

# Call your tRPC procedures
user = client.user.get(id=123)
posts = client.post.list(limit=10)

CLI Options

trpc-gen-python generate [options]

Options:
  -c, --config <path>  Path to config file (default: trpc-gen-python.toml)
  -h, --help          Display help
  -V, --version       Display version

Python Dependencies

The generated client requires:

pip install pydantic httpx

License

MIT

Contributing

Issues and pull requests welcome!