Quick Examples

Short, copy-pasteable snippets. For the full specifications, see Model Providers and Plugin SDK.

Model providers

smartassist-providers includes integrations for major AI providers:

#![allow(unused)]
fn main() {
use smartassist_providers::{anthropic::AnthropicProvider, Provider};

let provider = AnthropicProvider::from_env()?;
let response = provider.chat(
    "claude-sonnet-4-20250514",
    &[Message::user("Hello!")],
    None,
).await?;
}

Plugin SDK

Create custom plugins using the SDK:

#![allow(unused)]
fn main() {
use smartassist_plugin_sdk::prelude::*;

pub struct MyPlugin;

#[async_trait]
impl Plugin for MyPlugin {
    fn metadata(&self) -> PluginMetadata {
        PluginMetadata {
            name: "my-plugin".to_string(),
            version: Version::parse("1.0.0").unwrap(),
            description: "My custom plugin".to_string(),
            author: Some("Author".to_string()),
            homepage: None,
            license: Some("MIT".to_string()),
            capabilities: vec![PluginCapability::Tool],
            min_smartassist_version: None,
        }
    }

    async fn initialize(&mut self, ctx: &PluginContext) -> Result<()> {
        Ok(())
    }

    async fn shutdown(&mut self) -> Result<()> {
        Ok(())
    }

    fn as_any(&self) -> &dyn std::any::Any { self }
    fn as_any_mut(&mut self) -> &mut dyn std::any::Any { self }
}
}

Plugin capabilities:

• Channel - Custom messaging channels
• Tool - Custom agent tools
• ModelProvider - Custom AI model providers
• Hook - Middleware and interceptors
• Storage - Custom storage backends
• Media - Media processing

See examples/hello-plugin for a complete working plugin.