SalmAlm (삶앎)¶

Your Personal AI Gateway — 62 Tools, 6 Providers, Zero Dependencies.

pip install salmalm
salmalm

That's it. Open http://localhost:18800 and start talking.

What is SalmAlm?¶

SalmAlm is a personal AI assistant framework that runs entirely on your machine. It connects to multiple AI providers (Anthropic, OpenAI, Google, xAI, DeepSeek, local LLMs) and provides 62 built-in tools for coding, personal productivity, knowledge management, and more.

삶앎 (SalmAlm) = 삶(life) + 앎(knowledge) — "knowing life."

Key Features¶

🤖 6 AI Providers — Claude, GPT, Gemini, Grok, DeepSeek, Ollama/LM Studio
🔧 62 Built-in Tools — exec, web search, file ops, git, email, reminders, expenses, RAG...
💰 Smart Cost Optimization — Auto routing saves 83% vs always-Sonnet ($7.09→$1.23/day)
🔒 Encrypted Vault — API keys stored with AES-256, never in plaintext
📱 Telegram & Discord — Full bot integration with reactions, drafts, rich formatting
🧠 RAG Knowledge Base — Local vector search with Korean jamo support
🔌 MCP Server — Model Context Protocol for tool interoperability
📊 Web Dashboard — Real-time monitoring, session management, settings UI
🐍 Pure Python — Zero external dependencies, stdlib only

Quick Start¶

# Install
pip install salmalm

# Run
salmalm

# Or with specific port
salmalm --port 8080

On first launch, the setup wizard guides you through API key configuration.

Architecture¶

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Telegram    │     │   Web UI     │     │  Discord    │
│  Bot         │────▶│  :18800      │◀────│  Bot        │
└─────────────┘     └──────┬───────┘     └─────────────┘
                           │
                    ┌──────▼───────┐
                    │   Engine     │ ← Auto Routing
                    │  (Pipeline)  │ ← Context Mgmt
                    └──────┬───────┘ ← Tool Selection
                           │
              ┌────────────┼────────────┐
              │            │            │
        ┌─────▼─────┐ ┌───▼───┐ ┌─────▼─────┐
        │ Anthropic  │ │OpenAI │ │  Google   │
        │ xAI       │ │DeepSk │ │  Local    │
        └───────────┘ └───────┘ └───────────┘

Documentation¶

Getting Started — Installation and first setup
Commands — Slash commands reference
Tools — All 66 tools documented
Features — Deep dive into each feature
Configuration — Environment variables and settings
Architecture — Internal design and module structure
API Reference — HTTP API documentation
Deployment — Production deployment guide
FAQ — Frequently asked questions

Project Stats¶

Metric	Value
Python files	192
Total lines	~52K
Functions	~1,800
Test count	1,878
Max cyclomatic complexity	20
Largest file	778 lines
Docstring coverage	99%
Return type hints	81%