Àkàndé

A self-hosted, provider-agnostic voice assistant that delivers structured executive briefings via voice or text from 11 LLM providers.

Contents

Getting started

• Install : PyPI, source, system dependencies
• Requirements : toolchain floor, platforms
• Quick Start : voice briefing in ten lines

The Àkàndé ecosystem

• The Àkàndé ecosystem : core CLI, web server, MCP, and TUI modules

Library reference

• Capabilities at a glance : the current surface by theme
• Ecosystem comparison : short matrix; full table at docs/COMPARISON.md
• Benchmarks : headline numbers; full table at docs/BENCHMARKS.md
• Features : module-level capability list
• Configuration : core options
• Examples : runnable example index

Operational

• When not to use Àkàndé : limitations
• Development : make targets, fuzzing, CI
• Security : guarantees and compliance
• Documentation : all reference docs
• Stability guarantees : SemVer axis, output stability, minimum toolchain discipline
• License

Install

As a Python library

[dependencies]
akande = "^0.0.7"

# Core install : provider SDKs and mic capture are optional extras
pip install akande

# Full kit : every provider + microphone + MCP
pip install "akande[all,mic,mcp]"

From source

git clone https://github.com/sebastienrousseau/akande
cd akande
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

Requirements

Quick Start

import asyncio
import os

from akande.akande import Akande
from akande.providers.registry import get_provider

os.environ["LLM_PROVIDER"] = (
    "ollama"  # or openai, anthropic, google, claude_cli, etc.
)


async def main() -> None:
    provider = get_provider()
    assistant = Akande(openai_service=provider)
    response = await assistant.generate_response(
        "Provide a morning executive briefing on market trends."
    )
    print(response)


asyncio.run(main())

This runs the end-to-end Àkàndé pipeline: intent classification, safety wrapping, provider execution, and optional speech synthesis.

The Àkàndé ecosystem

Àkàndé provides a complete voice-first executive briefing stack across command-line, graphical terminal, REST, and protocol interfaces:

Capabilities at a glance

Ecosystem comparison

See docs/COMPARISON.md for the evidence and complete matrix.

Benchmarks

See docs/BENCHMARKS.md for methodology and full results.

Features

• 11 LLM Providers : Switch between OpenAI, Anthropic, Google Gemini, Claude Code CLI, Mistral, Cohere, Groq, Ollama, LM Studio, Azure, and Codex CLI.
• Safety Envelope : Strict transcript sanitization, control character stripping, length clamping, and <user_input> boundary envelopes.
• SSRF Prevention : Built-in host validation restricting loopbacks, private RFC 1918 subnets, link-local addresses, and cloud metadata services.
• Regulatory Transparency : Full EU AI Act Article 50 compliance with machine-readable audit manifests and AudioSeal watermarking.

Configuration

Set configuration through environment variables or .env files:

# Provider selection
export LLM_PROVIDER=openai  # anthropic, google, ollama, claude_cli, etc.

# Operational profile
export AKANDE_PROFILE=eu    # eu (strict compliance) or default

# Audio configuration
export AKANDE_TTS=kokoro    # gtts or kokoro
export AKANDE_STT=sr        # sr or faster_whisper

Examples

Runnable examples demonstrating features:

• examples/basic_briefing.py : Simple 10-line text briefing.
• examples/voice_interaction.py : Interactive microphone capture and voice synthesis.
• examples/mcp_server.py : Connecting Àkàndé tools to an MCP host.

When not to use Àkàndé

• Raw conversational chatbot : Àkàndé is optimized for structured, factual executive briefings and action synthesis rather than open-ended chit-chat.
• Ultra-low-latency telephony : Real-time sub-100ms voice agents require specialized WebRTC infrastructure; Àkàndé targets structured turn-taking.

Development

uv venv
uv pip install -e ".[all,dev]" mcp
uv run --extra dev pytest
uv run --extra dev ruff check .

All contributions must pass the verification gates (pytest with >= 95% coverage, ruff, mypy, bandit, pip-audit).

Security

Àkàndé enforces security best practices across input validation, network tools, and credential handling:

• Private IP and SSRF rejection on external fetch tools.
• Strict input sanitization and delimiter escaping on speech transcripts.
• Cryptographically signed audit manifests with SHA-256 sidecars.

Report vulnerabilities according to SECURITY.md.

Documentation

• User Guide
• Architecture
• Policies & Gates
• Development Guide

Stability guarantees

Àkàndé adheres to strict Semantic Versioning:

• Patch releases (0.0.x -> 0.0.y) : Backwards-compatible bug fixes and security patches.
• Breaking changes : Never introduced in patch releases. Deprecations documented at least one minor iteration in advance.

License

Dual-licensed under Apache-2.0 OR MIT at your option:

• Apache License, Version 2.0
• MIT License