Otherone

Otherone is a Rust AI agent framework with provider adapters, an agent loop, context management, tool calling, storage backends, Agent Skills discovery, and MCP client support.

Crates

• otherone: primary facade crate that re-exports the framework API.
• otherone-ai: AI provider abstraction for OpenAI, Anthropic, Fetch, OpenRouter, and local OpenAI-compatible endpoints.
• otherone-agent: non-streaming and streaming agent loop.
• otherone-context: session context loading, token estimation, and compaction.
• otherone-tools: tool call parsing and execution helpers.
• otherone-storage: local file, SQL, MongoDB, and Redis storage support.
• otherone-skills: Agent Skills SKILL.md discovery and validation.
• otherone-mcp: Model Context Protocol client support.

Install

Use the facade crate in another Rust project:

[dependencies]
otherone = "0.1"

During local development, depend on the workspace path:

[dependencies]
otherone = { path = "../otherone-agent/crates/otherone" }

Minimal Usage

use otherone::{
    agent::types::{AiOptions, ContextLoadType, InputOptions},
    ai::types::ProviderType,
    Otherone,
};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let input = InputOptions {
        session_id: "demo".to_string(),
        context_load_type: ContextLoadType::LocalFile,
        storage_type: None,
        context_window: 8192,
        threshold_percentage: Some(0.8),
        max_iterations: Some(8),
        database_config: None,
    };

    let mut ai = AiOptions {
        provider: ProviderType::OpenAI,
        api_key: std::env::var("OPENAI_API_KEY")?,
        base_url: "https://api.openai.com/v1".to_string(),
        model: "gpt-4o-mini".to_string(),
        user_prompt: Some("Hello from Otherone".to_string()),
        system_prompt: None,
        messages: None,
        context_length: Some(8192),
        temperature: Some(0.7),
        top_p: None,
        tools: None,
        tools_realize: None,
        tool_choice: None,
        parallel_tool_calls: None,
        stream: None,
        other: None,
    };

    let response = Otherone::invoke_agent(&input, &mut ai).await?;
    println!("{}", response.content);
    Ok(())
}

Package And Publish

Check package contents without publishing:

cargo package --workspace --allow-dirty

Publish dependency crates before crates that depend on them:

cargo login
cargo publish -p otherone-ai
cargo publish -p otherone-storage
cargo publish -p otherone-tools
cargo publish -p otherone-skills
cargo publish -p otherone-mcp
cargo publish -p otherone-context
cargo publish -p otherone-agent
cargo publish -p otherone

On Windows, you can use the included publish script:

cargo login
.\scripts\publish.ps1

Crates.io requires each published dependency version to already exist, so the facade crate otherone should be published last.