neuron

Umbrella crate for the neuron composable agent blocks ecosystem. Re-exports all neuron crates through a single dependency, with feature flags controlling which provider and integration blocks are included. This crate contains no logic of its own -- it exists purely for convenience.

Feature Flags

Module Map

Usage

Add neuron to your Cargo.toml with the features you need:

[dependencies]
neuron = { version = "0.1", features = ["anthropic", "mcp"] }

Then use the prelude for common imports:

use neuron::prelude::*;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // The prelude re-exports Provider, CompletionRequest, Message,
    // Role, ToolRegistry, AgentLoop, and other commonly used types.
    let provider = neuron::anthropic::Anthropic::new("sk-ant-...");

    let request = CompletionRequest {
        messages: vec![Message {
            role: Role::User,
            content: vec![ContentBlock::Text("Hello!".into())],
        }],
        max_tokens: Some(1024),
        ..Default::default()
    };

    let response = provider.complete(request).await?;

    for block in &response.message.content {
        println!("{block:?}");
    }
    Ok(())
}

Prelude Contents

The neuron::prelude module re-exports the most commonly used types:

• CompletionRequest, CompletionResponse, Message, Role, ContentBlock, ContentItem, SystemPrompt, TokenUsage, StopReason -- conversation primitives.
• Provider -- the LLM provider trait.
• Tool, ToolDyn, ToolDefinition, ToolContext, ToolOutput, ToolError -- tool system types.
• ToolRegistry -- tool registration and dispatch.
• SlidingWindowStrategy -- context compaction.
• AgentLoop, AgentLoopBuilder, AgentResult, LoopConfig -- the agentic loop.

Part of neuron

This is the root crate of neuron. For maximum independence, depend on individual block crates (neuron-types, neuron-provider-anthropic, etc.) directly.

License

Licensed under either of Apache License, Version 2.0 or MIT License at your option.