---
hide:
- toc
- navigation
---
<h1>
<img src="favicon.svg" style="height: 1.2em; vertical-align: middle; margin-right: 0.3em;">
phi-agent
</h1>
General-purpose AI Agent Framework in Rust — simple, pure, predictable.
<a href="guide/getting-started/" class="md-button md-button--primary" style="margin-right: 0.5rem">
:octicons-arrow-right-24: Get Started
</a>
<a href="https://github.com/hibuka-labs/phi-agent" class="md-button" target="_blank">
:octicons-mark-github-16: View on GitHub
</a>
---
<div class="grid cards" markdown>
- :simple-rust:{ .lg .middle } **Pure Rust**
---
Async, type-safe, zero-cost abstractions. A single binary that runs from cloud to edge.
- :material-lightbulb-on-outline:{ .lg .middle } **Simple**
---
No hidden state, no magic. Explicit control flow — readable, traceable, trustworthy.
</div>
<div class="grid cards" markdown>
- :material-toy-brick-outline:{ .lg .middle } **Your Rules**
---
Zero built-in tools. Implement the `Tool` trait, register what you need, own your capabilities.
- :material-chart-line:{ .lg .middle } **Observable**
---
Built-in turn logging, metrics, and tracing. Every decision is recorded, every outcome measurable.
</div>
---
## Architecture
``` title="Dependency Chain"
agent-base (runtime kernel + Tool trait)
↑
agent-works (MCP, Skills, Focus)
↑
phi-agent (lib) ← framework, no tools
↑
Your App (CLI, web, etc.) ← you register tools here
```
Each crate is a separate repository under [hibuka-labs](https://github.com/hibuka-labs). All built on Rust's async runtime with `Arc<dyn LlmClient>` for provider abstraction.
## Links
<div class="grid cards" markdown>
- [:octicons-mark-github-16: GitHub](https://github.com/hibuka-labs/phi-agent)
Source code, issues, discussions.
- [:simple-rust: crates.io](https://crates.io/crates/phi-agent)
Add with `cargo add phi-agent`.
- [:material-bookshelf: API Docs](https://docs.rs/phi-agent)
Full Rustdoc on docs.rs.
</div>
---
:material-email-outline: **Contact** [phiagent@hibuka.com](mailto:phiagent@hibuka.com)
