chi

A lightweight, idiomatic Go HTTP router built entirely on net/http, for composing middleware and mounting REST APIs without a framework.

Library
Go
vv1.5.5
23,059 stars
MIT License

Repository Health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum. How we score it →
81 /100 Excellent
Development Activity 80
Maintenance 76
Community 68
Maturity 60
Momentum 40

Technical Analysis

AI-assessed by reading the actual repository — architecture, code quality, innovation, and documentation. How we score it →
80 /100 Excellent
Architecture 85
Code Quality 88
Innovation 60
Learning Curve 85

chi is a small, composable router for building HTTP services in Go. Rather than wrapping or replacing the standard library, it builds directly on net/http, so every handler, middleware, and http.Handler from the wider Go ecosystem works with it unmodified. The router core is deliberately tiny (well under 1000 lines) and adds zero external dependencies, while still supporting named URL parameters, regexp-constrained segments, wildcard matching, and nested route groups.

What sets chi apart from a bare http.ServeMux is its support for structuring large APIs: Route() and Mount() let you compose independent sub-routers with their own middleware stacks, Group() scopes inline middleware to a subset of routes, and docgen can generate JSON or Markdown documentation directly from the routing tree. A companion middleware subpackage ships dozens of ready-made handlers — request IDs, structured logging, panic recovery, compression, rate limiting, and more — all written as ordinary func(http.Handler) http.Handler chains.

Under the hood, chi routes requests through a Patricic radix trie, giving predictable, allocation-conscious performance regardless of how many routes are registered. It has been running in production at Cloudflare, Heroku, 99Designs, and Pressly (chi’s originating team) for years, and the project maintains explicit compatibility with the four most recent Go major versions.

What You Get

  • A Mux implementing http.Handler, so it drops into any existing net/http server with zero adapter code
  • Named URL parameters ({userID}), regexp-constrained segments ({number:\d+}), and wildcard matching (/page/*)
  • Route(), Mount(), and Group() for composing large APIs out of independently middleware-scoped sub-routers
  • A middleware subpackage with dozens of stdlib-compatible handlers: request ID, structured logging, panic recovery, compression, timeouts, rate limiting, client-IP resolution
  • docgen-compatible route introspection via the Routes interface, for generating JSON/Markdown API docs straight from the routing tree
  • Zero external dependencies — pure Go standard library plus net/http

Common Use Cases

  • Building REST APIs that need explicit control over routing and middleware without adopting a full web framework
  • Migrating a net/http-based service off ServeMux once URL parameters, groups, or sub-router mounting become necessary
  • Composing microservices where each has an isolated middleware stack (auth, logging, rate limiting) mounted under a shared root router
  • Generating machine-readable route documentation for internal API catalogs via docgen
  • Building admin or versioned API surfaces (/admin, /v1, /v2) as separately mountable sub-routers with their own middleware

Under The Hood

Architecture

chi’s core lives in three files: mux.go defines the Mux struct (an http.Handler wrapping a middleware chain and a routing tree), tree.go implements the radix trie that stores and matches URL patterns, and chi.go defines the public Router/Routes interfaces. A sync.Pool of Context objects (context.go) avoids per-request allocation for route params. Sub-routers created via Route() or attached via Mount() keep a parent pointer back to their owning Mux, so middleware scoping stays local to each mounted branch while route matching still traverses a single shared trie — a clean separation between routing (tree) and request processing (middleware chain) that means adding a new mounted service touches no existing router’s internals.

Tech Stack

The module (github.com/go-chi/chi, migrated to github.com/go-chi/chi/v5 at HEAD) targets the four most recent Go major versions and declares zero runtime dependencies — everything is built on net/http, context, and sync. The middleware subpackage is a separate, optional import so consumers only pull in what they use. docgen and render exist as separate companion repositories rather than being bundled, keeping the core router’s dependency graph minimal.

Code Quality

The project is heavily tested: mux_test.go (2100+ lines) and tree_test.go (700+ lines) exercise routing edge cases, wildcard precedence, and trie construction directly, alongside dedicated test files for most middleware handlers. CI (.github/workflows/ci.yml) runs the suite across four Go versions and both Linux and Windows on every push and PR. Error handling favors explicit http.Error calls in examples over panics, and the public API surface is small and consistently named (Get, Post, Route, Mount, Use), which keeps the exported interface easy to audit.

What Makes It Unique

Unlike full-stack frameworks, chi’s entire value proposition is staying inside the net/http type system rather than replacing it — Mux is an http.Handler, middleware are func(http.Handler) http.Handler, and handlers are http.HandlerFunc. This makes it trivially composable with any other net/http-compatible package in the Go ecosystem, and lets teams mount independently-owned sub-routers as isolated units, a pattern that’s earned it long-standing adoption at companies running large, decomposed API surfaces.

Used by 24 apps in this directory

TypeScript
49%
Apache 2.0

agent-orchestrator

AI Agents · AI Code Assistants · Developer Tools

14,187

A local desktop workspace that gives every coding task its own agent, Git branch, and worktree, then tracks tasks, pull requests, CI, and reviews for 27 coding agents on one live Kanban board.

View details
87
Repo Health
83
Technical
67
Dependency
Built with
TypeScript 49%
Go 49%
Updated 1 weeks ago
Go
99%
Apache 2.0

Caddy

Devops · Security

78,855

The only web server that obtains and renews TLS certificates automatically, with HTTP/1-2-3 support and zero dependency on external runtimes.

View details
93
Repo Health
86
Technical
71
Dependency
Built with
Go 99%
Updated 1 weeks ago
Go
74%
AGPL 3.0

Coder

Code Editors · Developer Tools · Devops

17,311

Self-hosted cloud development environments and AI coding agents — defined in Terraform, connected via WireGuard, automatically shut down when idle.

View details
91
Repo Health
90
Technical
66
Dependency
Built with
Go 74%
TypeScript 24%
Updated 1 weeks ago
Go
71%
Other

Convoy

Developer Tools · Devops

2,888

Convoy is an open-source, cloud-native webhooks gateway that ingests events over HTTP or straight from Kafka, SQS, Google Pub/Sub, and RabbitMQ, then reliably delivers them to subscriber endpoints with signed payloads, automatic retries, circuit breaking, and JavaScript-based transformations.

View details
88
Repo Health
81
Technical
66
Dependency
Built with
Go 71%
TypeScript 15%
HTML 12%
Updated 1 weeks ago
Go
49%
Other

Cosmos-Server

Authentication · Security

6,193

All-in-one self-hosted home server with SmartShield anti-DDoS, Nebula mesh VPN, automatic HTTPS, and a 250-app marketplace — all secured behind a unified auth layer.

View details
80
Repo Health
59
Technical
65
Dependency
Built with
Go 49%
JavaScript 48%
Updated 3 weeks ago
Go
79%
AGPL 3.0

dsforms

Forms Surveys

7

Self-hosted form backend for static sites — one Go binary, one SQLite file, with spam quarantine, waitlists, webhooks, and email notifications.

View details
43
Repo Health
86
Technical
63
Dependency
Built with
Go 79%
HTML 14%
Updated 1 months ago
Go
47%
Apache 2.0

e2a

AI Agents · Automation

198

Give your AI agents a real, authenticated email address — with SPF/DKIM-verified inbound, HMAC-signed delivery, WebSocket fan-out, and human-in-the-loop approval built in.

View details
79
Repo Health
80
Technical
71
Dependency
Built with
Go 47%
TypeScript 27%
Python 13%
Updated 1 weeks ago
Go
76%
Other

Flipt

Developer Tools · Devops

4,938

Git-native feature flag platform that stores, versions, and deploys feature toggles directly in your own Git repositories with no external database required.

View details
90
Repo Health
83
Technical
68
Dependency
Built with
Go 76%
TypeScript 23%
Updated 1 weeks ago
Go
83%
MIT

Gitea

Developer Tools · Devops · Project Management

58,932

Self-hosted DevOps in a single Go binary — Git hosting, GitHub Actions-compatible CI/CD, and 30+ package registries without any SaaS dependency.

View details
93
Repo Health
79
Technical
64
Dependency
Built with
Go 83%
Updated 1 weeks ago

Join founders buildingwith open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on Substack
Join 750+ subscribers