# Dexpot

> Dexpot is an open-source synchronous Python API framework that adapts concurrency to standard GIL and free-threaded CPython while keeping the same plain synchronous handlers.

## Primary resources

- [Documentation](https://dexpot.modepot.io/): Framework overview and current documentation.
- [Quick start](https://dexpot.modepot.io/quick-start/): Install, define, serve, and call a typed API.
- [Execution model](https://dexpot.modepot.io/execution-model/): GIL pools, free-threaded connection threads, overload behavior, and process fan-out.
- [Route contract](https://dexpot.modepot.io/route-contract/): Registration, path captures, msgspec bodies, responses, and request context.
- [HTTP boundary](https://dexpot.modepot.io/http-boundary/): Request limits, parser selection, and protocol policy.
- [Current boundaries](https://dexpot.modepot.io/current-boundaries/): Explicit alpha limitations and non-features.
- [Source repository](https://github.com/tugrulguner/dexpot): Source, issues, releases, examples, and contribution guidance.

## Key facts

- Language: Python 3.12 and newer.
- License: MIT.
- Package: `dexpot` on PyPI.
- Handlers are synchronous Python functions.
- Routes compile into immutable endpoint and application plans before the listener opens.
- Standard GIL builds use a bounded thread pool and optional POSIX process fan-out.
- Free-threaded builds use one process with capped connection-owning threads.
- JSON request bodies use msgspec decoding and validation.
- The optional Rust/PyO3 extension parses request heads only; Python continues to own sockets, bodies, routing, handlers, and scheduling.
- Dexpot is alpha software and is not yet recommended for untrusted production traffic.