Crates

Small crates. Composable architecture.

Use the entire framework or take only the pieces you need.

crate graph · hover to trace dependencies
agent-coreFoundationcognitionReasoningmessagingTransportpatternsCoordinationruntimeExecutionrustyaiFacadeFoundation

Hover a crate to highlight its dependencies and API role.

agent-core

Level 0 — Foundation

The foundation for autonomous agents.

Agent, AgentId, AgentContext, lifecycle hooks, and state management. Everything an autonomous unit needs to exist, be addressed, and be driven by a runtime.

key APIs: Agent · AgentId · AgentContext · AgentState · LifecycleHooks

cognition

Level 1 — Reasoning

Give agents actual reasoning architecture.

BDI beliefs, desires, intentions, reasoning, planning, utility functions, and intention management — a cognitive loop instead of a callback soup.

key APIs: BeliefBase · Desire · Intention · Planner · UtilityFn

messaging

Level 1 — Transport

Agents need to communicate.

FIPA-inspired ACL, typed messages, bounded mailboxes, routing, and request-reply protocols with backpressure built in.

key APIs: AclMessage · Performative · Mailbox · Router · RequestReply

patterns

Level 2 — Coordination

Coordinate agents as organizations.

Hierarchy, Swarm, Market, Coalition, Holarchy, Federation, Blackboard, and Team — reusable coordination topologies rather than bespoke glue.

key APIs: Hierarchy · Swarm · Market · Coalition · Blackboard

runtime

Level 2 — Execution

Run agents reliably.

Tokio-powered execution, supervision, restart policies, circuit breakers, health checks, metrics, sandboxing, and scheduling.

key APIs: Runtime · Supervisor · RestartPolicy · HealthCheck · Scheduler

rustyai

Level 3 — Facade

One facade for the entire framework.

A unified API and prelude that re-exports the framework's core capabilities, so a single dependency gets you the whole agent stack.

key APIs: prelude::* · AgentBuilder · RustyAI

Add the facade and start building.

cargo add rustyai gets you the prelude, runtime, cognition, and coordination patterns.