ailloy 0.1.0

Ailloy provides a unified interface for interacting with multiple AI providers from Rust — both as a CLI tool for quick tasks and scripting, and as a library for integration into your own projects.

Quick Start

Install the CLI

# Homebrew (macOS/Linux)
brew install mklab-se/tap/ailloy

# Cargo
cargo install ailloy

# Cargo binstall (pre-built binary)
cargo binstall ailloy

Configure a provider

ailloy config init

Send a message

ailloy chat "Explain the Rust borrow checker in one sentence"

Use as a Library

Add ailloy to your project without CLI dependencies:

[dependencies]
ailloy = { version = "0.1", default-features = false }
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
anyhow = "1"

use ailloy::config::Config;
use ailloy::provider::create_provider;
use ailloy::types::Message;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let config = Config::load()?;
    let provider = create_provider(&config)?;
    let response = provider.chat(&[Message::user("Hello!")]).await?;
    println!("{}", response.content);
    Ok(())
}

Or configure a provider directly in code:

use ailloy::openai::OpenAiClient;
use ailloy::types::Message;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let client = OpenAiClient::new("sk-...", "gpt-4o", None);
    let response = client.chat(&[Message::user("Hello!")]).await?;
    println!("{}", response.content);
    Ok(())
}

Providers

Configuration

Ailloy stores its configuration at ~/.config/ailloy/config.yaml:

default_provider: openai
providers:
  openai:
    kind: openai
    api_key: sk-...
    model: gpt-4o
  ollama:
    kind: ollama
    model: llama3.2
  claude:
    kind: local-agent
    binary: claude

CLI Commands

Options

ailloy chat "message" --provider ollama    # Use a specific provider
ailloy chat "message" --system "Be brief"  # Set a system prompt
ailloy -v chat "message"                   # Debug logging
ailloy -q chat "message"                   # Quiet mode

Feature Flags

Ailloy uses feature flags to keep the library lean:

Library users should disable default features:

ailloy = { version = "0.1", default-features = false }

Development

cargo build                              # Build everything
cargo build --no-default-features --lib  # Build library only
cargo test                               # Run tests
cargo clippy -- -D warnings              # Lint (zero warnings)
cargo fmt --all -- --check               # Format check
cargo run -- chat "hello"                # Run the CLI

License

MIT