Praxium
Praxium is a typed, asynchronous foundation for AI agents and graph workflows. It is designed around explicit state, deterministic routing, structured events, cancellation, retries, timeouts, checkpoints, and provider-neutral extension interfaces.
Status:
0.1.0alpha. The executable core is being built against the tracked implementation plan.
Quick start
python -m pip install -e .
python examples/quickstart.py
Install production model adapters:
python -m pip install -e ".[providers]"
from praxium import Model
from praxium.providers import ProviderFactory
provider = ProviderFactory.ollama()
model = Model(name="qwen3:8b", provider=provider.name)
Praxium includes native OpenAI, Anthropic, Gemini, Amazon Bedrock, and Google Vertex AI protocol support plus named presets for Azure OpenAI, Groq, Together, OpenRouter, Kimi, GLM, Ollama, and Hugging Face. Arbitrary OpenAI-compatible endpoints and completely custom provider callables are supported without a model-name allowlist.
from praxium import GraphBuilder, Runtime, State
async def greet(state: State, _context):
return {"greeting": f"Hello, {state.data['name']}!"}
graph = (
GraphBuilder("hello")
.add_node("greet", greet)
.set_entrypoint("greet")
.set_finish_point("greet")
.build()
)
result = await Runtime().run(graph, State(data={"name": "Ada"}))
print(result.state.data["greeting"])
Design principles
- Everything crossing a public boundary is typed.
- Every execution produces correlated, ordered events.
- State and checkpoints are serializable and reproducible.
- The runtime is async and cancellation-aware.
- Provider, database, web, and CLI dependencies are optional adapters.
- Extension points use explicit protocols and conflict-safe registries.
Development
python -m pip install -e ".[dev]"
ruff format --check .
ruff check .
mypy src
pytest --cov=praxium --cov-branch
The architecture, milestones, acceptance criteria, and v0.1 boundary are recorded in docs/IMPLEMENTATION_PLAN.md. Repository-wide engineering constraints live in AGENTS.md.
Documentation
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file praxium-0.1.0.tar.gz.
File metadata
- Download URL: praxium-0.1.0.tar.gz
- Upload date:
- Size: 104.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4646350ef6b273be0c03b5b065a669b94ca646e3dd7da1bef56678630c40a72a
|
|
| MD5 |
16f106ef9a66b7d654f5b9369332f1af
|
|
| BLAKE2b-256 |
9f6151f1d4d13236a691c3cb974911f02f7f61308106e206615c906cb8f7a8dc
|
Provenance
The following attestation bundles were made for praxium-0.1.0.tar.gz:
Publisher:
publish.yml on rebel47/Praxium
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
praxium-0.1.0.tar.gz -
Subject digest:
4646350ef6b273be0c03b5b065a669b94ca646e3dd7da1bef56678630c40a72a - Sigstore transparency entry: 2336711848
- Sigstore integration time:
-
Permalink:
rebel47/Praxium@53858f7ad0db5d51bcb5383a3e2edffb86363e44 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/rebel47
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@53858f7ad0db5d51bcb5383a3e2edffb86363e44 -
Trigger Event:
release
-
Statement type:
File details
Details for the file praxium-0.1.0-py3-none-any.whl.
File metadata
- Download URL: praxium-0.1.0-py3-none-any.whl
- Upload date:
- Size: 83.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a7f30c6293af20ff4c4bb97fb0be6274165e64003b405172044a467604654fb9
|
|
| MD5 |
e46eda363731aae829c9e0a8d2a4de56
|
|
| BLAKE2b-256 |
9af9abadddf031b846152ae7809b8d278fbf5b3d8b64fd74c867eb50294cb381
|
Provenance
The following attestation bundles were made for praxium-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on rebel47/Praxium
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
praxium-0.1.0-py3-none-any.whl -
Subject digest:
a7f30c6293af20ff4c4bb97fb0be6274165e64003b405172044a467604654fb9 - Sigstore transparency entry: 2336711924
- Sigstore integration time:
-
Permalink:
rebel47/Praxium@53858f7ad0db5d51bcb5383a3e2edffb86363e44 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/rebel47
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@53858f7ad0db5d51bcb5383a3e2edffb86363e44 -
Trigger Event:
release
-
Statement type:
