PRAXO-CORE
An embeddable MIT-licensed agent framework with explicit policy controls, checkpoints, and event tracing.
Build governed agents inside your own product without rebuilding the agent loop, model abstraction, tool contracts, or execution boundaries. Use your own model providers and integrations. AxisVela products are not required.
Documentation | Quickstart | Language Implementations | Examples
Start With Go
go get github.com/axisvela/praxo-core/[email protected]
Run the quickstart from a checkout using Ollama:
export PRAXO_BASE_URL=http://localhost:11434/v1
export PRAXO_MODEL=llama3.2
GOWORK=off go run ./examples/quickstart
Or connect an OpenAI-compatible endpoint:
export PRAXO_BASE_URL=https://api.openai.com/v1
export PRAXO_API_KEY=...
export PRAXO_MODEL=gpt-4o-mini
GOWORK=off go run ./examples/quickstart
Use Go 1.26.10, the tested CI/release toolchain. On PowerShell, set environment
variables with $env:PRAXO_BASE_URL = "..." and the same names. The example
demonstrates tools, streamed text, events, and policy. See the
quickstart guide for prerequisites.
Why PRAXO-CORE
- Explicit governance: policy hooks, tool authorization, and HITL decisions.
- Recoverable execution: checkpoint and session contracts with resume support.
- Observable behavior: structured events and optional OpenTelemetry integration.
- Provider-neutral embedding: model, memory, tool, retrieval, and sandbox interfaces.
- MIT boundary: optional integrations stay separate from the core framework.
It is a framework, not a hosted agent service, vector database, model provider, or turnkey chat UI. Review the adoption guide, security model, and framework comparison before choosing it.
Choose Your Language
Go is the reference implementation. SDKs share a normative contract in
spec/, with language-specific APIs and declared limitations.
Source releases, package-registry publication, conformance, and production verification are different states. Follow each language's installation instructions and support policy; do not infer full Go feature parity or registry availability from a source tag.
Examples
Repository Map
Go module paths remain unchanged. Language sources have moved under language/,
bindings/, and examples/; see the source migration guide.
Framework and Ecosystem
PRAXO-CORE is an independent MIT-licensed framework.
Connect models, memory, events, retrieval, and policy through your own adapters or optional AxisVela integrations. See the adapter directory for module scope and limitations.
Releases and Contributing
Core 2.5.0 adds the conformance package and local VFS hardening. Optional
adapters and SDKs are versioned independently.
- Latest release notes
- Release history
- Compatibility policy
- v2 migration
- Public roadmap
- Contributing
- Security reporting
License
MIT. See LICENSE and provenance.