Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Moltis

Alpha software: use with care

Running an AI assistant on your own machine or server is still new territory. Treat Moltis as alpha software: run it in isolated environments, review enabled tools/providers, keep secrets scoped and rotated, and avoid exposing it publicly without strong authentication and network controls.

A personal AI gateway written in Rust.
One binary, no runtime, no npm.

Moltis compiles your entire AI gateway — web UI, LLM providers, tools, and all assets — into a single self-contained executable. There’s no Node.js to babysit, no node_modules to sync, no V8 garbage collector introducing latency spikes.

# Quick install (macOS / Linux)
curl -fsSL https://www.moltis.org/install.sh | sh

Why Moltis?

FeatureMoltisOther Solutions
DeploymentSingle binaryNode.js + dependencies
Memory SafetyRust ownershipGarbage collection
Secret HandlingZeroed on drop“Eventually collected”
SandboxDocker + Apple ContainerDocker only
StartupMillisecondsSeconds

Key Features

  • Multiple LLM Providers — Anthropic, OpenAI, Google Gemini, DeepSeek, Mistral, Groq, xAI, OpenRouter, Ollama, Local LLM, and more
  • Streaming-First — Responses appear as tokens arrive, not after completion
  • Sandboxed Execution — Commands run in isolated containers (Docker or Apple Container)
  • MCP Support — Connect to Model Context Protocol servers for extended capabilities
  • Multi-Channel — Web UI, Telegram, Discord, API access with synchronized responses
  • Built-in Throttling — Per-IP endpoint limits with strict login protection
  • Long-Term Memory — Embeddings-powered knowledge base with hybrid search
  • Hook System — Observe, modify, or block actions at any lifecycle point
  • Compile-Time Safety — Misconfigurations caught by cargo check, not runtime crashes

See the full list of supported providers.

Quick Start

# Install
curl -fsSL https://www.moltis.org/install.sh | sh

# Run
moltis

On first launch:

  1. Open the URL shown in your browser (e.g., http://localhost:13131)
  2. Add your LLM API key
  3. Start chatting!

Note

Authentication is only required when accessing Moltis from a non-localhost address. On localhost, you can start using it immediately.

Full Quickstart Guide

How It Works

┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐
│  Web UI  │  │ Telegram │  │ Discord  │  │   API    │
└────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘
     │             │             │             │
     └─────────────┴─────────┬───┴─────────────┘
                             │
                             ▼
        ┌───────────────────────────────┐
        │       Moltis Gateway          │
        │   ┌─────────┐ ┌───────────┐   │
        │   │  Agent  │ │   Tools   │   │
        │   │  Loop   │◄┤  Registry │   │
        │   └────┬────┘ └───────────┘   │
        │        │                      │
        │   ┌────▼────────────────┐     │
        │   │  Provider Registry  │     │
        │   │ Anthropic·OpenAI·Gemini… │   │
        │   └─────────────────────┘     │
        └───────────────────────────────┘
                        │
                ┌───────▼───────┐
                │    Sandbox    │
                │ Docker/Apple  │
                └───────────────┘

Documentation

Getting Started

Features

  • Providers — Configure LLM providers
  • MCP Servers — Extend with Model Context Protocol
  • Hooks — Lifecycle hooks for customization
  • Local LLMs — Run models on your machine

Deployment

  • Docker — Container deployment

Architecture

Security

Moltis applies defense in depth:

  • Authentication — Password or passkey (WebAuthn) required for non-localhost access
  • SSRF Protection — Blocks requests to internal networks
  • Secret Handlingsecrecy::Secret zeroes memory on drop
  • Sandboxed Execution — Commands never run on the host
  • Origin Validation — Prevents Cross-Site WebSocket Hijacking
  • No Unsafe Codeunsafe is denied workspace-wide

Community

License

MIT — Free for personal and commercial use.