How-To Guides

Practical guides for composing and extending Axio in your applications.

Start with Choose a transport in application code to discover installed providers, select a model, and run an agent through core without importing REPL or TUI. Use Register and discover plugins for entry-point groups, registration examples, discovery behavior, and plugin lifecycles.

You can extend Axio with tools, providers, guards, selectors, context stores, and transports. Writing Transports is the longest of them, because a transport is the only place that knows a provider exists. It reads the provider’s stream through axio-sse, converts its token counts, maps its stop reasons, and replays its reasoning.