Skip to content
Back to search

moltis

A secure persistent personal agent server in Rust. One binary, sandboxed execution, multi-provider LLMs, voice, memory, Telegram, WhatsApp, Discord, Teams, and MCP tools. Secure by design, runs on your hardware.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/moltis-org--moltis/badge.svg)](/listings/moltis-org--moltis)

HTML

<a href="/listings/moltis-org--moltis"><img src="/api/listings/moltis-org--moltis/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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

# macOS / Linux via Homebrew
brew install moltis-org/tap/moltis

# Docker (multi-arch: amd64/arm64)
docker pull ghcr.io/moltis-org/moltis:latest

# Or build from source
cargo install moltis --git https://github.com/moltis-org/moltis

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 243 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <a href="https://moltis.org"><img src="https://raw.githubusercontent.com/moltis-org/moltis/main/website/favicon.svg" alt="Moltis" width="64"></a>
  3. # Moltis — A secure persistent personal agent server in Rust
  4. One binary — sandboxed, secure, yours.
  5. [![CI](https://github.com/moltis-org/moltis/actions/workflows/ci.yml/badge.svg)](https://github.com/moltis-org/moltis/actions/workflows/ci.yml)
  6. [![codecov](https://codecov.io/gh/moltis-org/moltis/graph/badge.svg)](https://codecov.io/gh/moltis-org/moltis)
  7. [![CodSpeed](https://img.shields.io/endpoint?url=https://codspeed.io/badge.json&style=flat&label=CodSpeed)](https://codspeed.io/moltis-org/moltis)
  8. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  9. [![Rust](https://img.shields.io/badge/Rust-1.91%2B-orange.svg)](https://www.rust-lang.org)
  10. [![Discord](https://img.shields.io/discord/1469505370169933837?color=5865F2&label=Discord&logo=discord&logoColor=white)](https://discord.gg/XnmrepsXp5)
  11. [Installation](#installation) • [Comparison](#comparison) • [Architecture](#architecture--crate-map) • [Security](#security) • [Features](#features) • [How It Works](#how-it-works) • [Contributing](CONTRIBUTING.md)
  12. </div>
  13. ---
  14. Moltis recently hit [the front page of Hacker News](https://news.ycombinator.com/item?id=46993587). Please [open an issue](https://github.com/moltis-org/moltis/issues) for any friction at all. I'm focused on making Moltis excellent.
  15. **Secure by design** — Your keys never leave your machine. Every command runs in a sandboxed container, never on your host.
  16. **Your hardware** — Runs on a Mac Mini, a Raspberry Pi, or any server you own. One Rust binary, no Node.js, no npm, no runtime.
  17. **Full-featured** — Voice, memory, cross-session recall, automatic edit checkpoints, scheduling, Telegram, Signal, Discord, browser automation, MCP servers, SSH or node-backed remote exec, managed deploy keys with host pinning in the web UI, a live Settings → Tools inventory, Cursor-compatible project context, and context-file threat scanning — all built-in. No plugin marketplace to get supply-chain attacked through.
  18. **Auditable** — The agent runner and model interface fit in ~7.5K lines, with providers in ~19K more. The Rust workspace is ~270K lines across 59 modular crates you can audit independently, with 470+ Rust files containing tests. Unsafe code is isolated to FFI and precompiled runtime boundaries, not the core agent loop.
  19. ## Installation
  20. ```bash
  21. # One-liner install script (macOS / Linux)
  22. curl -fsSL https://www.moltis.org/install.sh | sh
  23. # macOS / Linux via Homebrew
  24. brew install moltis-org/tap/moltis
  25. # Docker (multi-arch: amd64/arm64)
  26. docker pull ghcr.io/moltis-org/moltis:latest
  27. # Or build from source
  28. cargo install moltis --git https://github.com/moltis-org/moltis
  29. ```
  30. ## Comparison
  31. | | OpenClaw | Hermes Agent | **Moltis** |
  32. |---|---|---|---|
  33. | Primary stack | TypeScript + Swift/Kotlin companion apps | Python + TypeScript TUI/web surfaces | **Rust** |
  34. | Runtime | Node.js + npm/pnpm/bun | Python + uv/pip, optional Node UI pieces | **Single Rust binary** |
  35. | Local checkout size\* | ~1.1M app LoC | ~152K app LoC | **~270K Rust LoC** |
  36. | Architecture | Broad gateway, channel, node, and app ecosystem | CLI/gateway agent with learning loop and research tooling | **Persistent personal agent server with modular crates** |
  37. | Crates/modules | npm packages, extensions, apps | Python packages, plugins, tools, TUI | **59 Rust workspace crates** |
  38. | Sandbox/backends | App-level permissions, browser/node tools | Local, Docker, SSH, Daytona, Singularity, Modal | **Docker/Podman + Apple Container + WASM** |
  39. | Auth/access | Pairing and local gateway controls | CLI and messaging gateway setup | **Password + Passkey + API keys + Vault** |
  40. | Voice I/O | Voice wake and talk modes | Voice memo transcription | **Built-in STT + TTS providers** |
  41. | MCP | Plugin/integration support | MCP integration | **stdio + HTTP/SSE** |
  42. | Skills | Bundled, managed, and workspace skills | Self-improving skills and Skills Hub support | **Bundled/workspace skills + autonomous improvement + OpenClaw import** |
  43. | Memory/RAG | Plugin-backed memory and context engine | Agent-curated memory, session search, user modeling | **SQLite + FTS + vector memory** |
  44. \* LoC measured with `tokei`, excluding `node_modules`, generated build output, `dist`, and `target`.
  45. > [Full comparison in the docs →](https://docs.moltis.org/comparison.html)
  46. ## Architecture — Crate Map
  47. Current Rust workspace: ~270K LoC across 59 crates. The table below groups the main crates by role so the architecture stays scannable.
  48. **Core runtime**:
  49. | Crate | LoC | Role |
  50. |-------|-----|------|
  51. | `moltis-gateway` | 37.4K | HTTP/WS server, RPC, auth, startup wiring |
  52. | `moltis-tools` | 37.0K | Tool execution, sandboxing, WASM tools |
  53. | `moltis-providers` | 18.9K | LLM provider implementations |
  54. | `moltis-agents` | 14.5K | Agent loop, streaming, prompt assembly |
  55. | `moltis-chat` | 14.2K | Chat engine, agent orchestration |
  56. | `moltis-config` | 10.3K | Configuration, validation |
  57. | `moltis-httpd` | 9.9K | HTTP server primitives and middleware |
  58. | `moltis` (CLI) | 4.7K | Entry point, CLI commands |
  59. | `moltis-sessions` | 3.5K | Session persistence |
  60. | `moltis-common` | 1.5K | Shared utilities |
  61. | `moltis-service-traits` | 1.2K | Shared service interfaces |
  62. | `moltis-protocol` | 0.7K | Wire protocol types |
  63. **Feature and integration crates**:
  64. | Category | Crates | Combined LoC |
  65. |----------|--------|-------------|
  66. | Channels | `moltis-telegram`, `moltis-whatsapp`, `moltis-signal`, `moltis-discord`, `moltis-msteams`, `moltis-matrix`, `moltis-slack`, `moltis-nostr`, `moltis-channels` | 34.0K |
  67. | Web and APIs | `moltis-web`, `moltis-graphql`, `moltis-webhooks` | 10.8K |
  68. | Extensibility | `moltis-mcp`, `moltis-mcp-agent-bridge`, `moltis-skills`, `moltis-plugins` | 11.5K |
  69. | Memory and context | `moltis-memory`, `moltis-qmd`, `moltis-code-index`, `moltis-projects` | 11.7K |
  70. | Voice and browser | `moltis-voice`, `moltis-browser` | 9.2K |
  71. | Auth and security | `moltis-auth`, `moltis-oauth`, `moltis-vault`, `moltis-secret-store`, `moltis-network-filter`, `moltis-tls` | 8.5K |
  72. | Scheduling and automation | `moltis-cron`, `moltis-caldav`, `moltis-auto-reply` | 4.7K |
  73. | Setup and import | `moltis-provider-setup`, `moltis-openclaw-import`, `moltis-onboarding` | 11.7K |
  74. | Native and node hosts | `moltis-swift-bridge`, `moltis-node-host`, `moltis-courier` | 5.7K |
  75. | WASM tools | `moltis-wasm-precompile`, `moltis-wasm-calc`, `moltis-wasm-web-fetch`, `moltis-wasm-web-search` | 1.4K |
  76. | Supporting crates | `moltis-media`, `moltis-metrics`, `moltis-tailscale`, `moltis-routing`, `moltis-canvas`, `moltis-schema-export`, `benchmarks` | 2.1K |
  77. Use `--no-default-features --features lightweight` for constrained devices (Raspberry Pi, etc.).
  78. ## Security
  79. - **Small unsafe surface** — core agent/gateway code stays safe Rust; unsafe is isolated to Swift FFI, local model wrappers, and precompiled WASM boundaries
  80. - **Sandboxed execution** — Docker + Apple Container, per-session isolation
  81. - **Secret handling** — `secrecy::Secret`, zeroed on drop, redacted from tool output
  82. - **Authentication** — password + passkey (WebAuthn), rate-limited, per-IP throttle
  83. - **SSRF protection** — DNS-resolved, blocks loopback/private/link-local
  84. - **Origin validation** — rejects cross-origin WebSocket upgrades
  85. - **Hook gating** — `BeforeToolCall` hooks can inspect/block any tool invocation
  86. - **Supply chain integrity** — [artifact attestations](https://github.com/moltis-org/moltis/attestations), Sigstore keyless signing, GPG signing (YubiKey), SHA-256/SHA-512 checksums
  87. See [Security Architecture](https://docs.moltis.org/security.html) for details.
  88. Verify releases with `gh attestation verify <artifact> -R moltis-org/moltis` or see [Release Verification](https://docs.moltis.org/release-verification.html).
  89. ## Features
  90. - **Reasoning Defaults** - Configurable default thinking effort for model-less and new main sessions, with explicit per-session Off or level overrides
  91. - **AI Gateway** — Multi-provider LLM support (OpenAI Codex, GitHub Copilot, Local), streaming responses, agent loop with sub-agent delegation, session modes, parallel tool execution
  92. - **Communication** — Web UI with command-palette agent prompts and Markdown copy/export, Telegram, Signal, Microsoft Teams, Discord, Slack with native live tool cards, Nostr DMs + NIP-29 group chat (incl. Block's Buzz channels), API access, voice I/O (8 TTS + 7 STT providers), mobile PWA with push notifications
  93. - **Desktop App** — Native Rust/gpui client that attaches to a running daemon locally, over HTTPS, or through an SSH tunnel; keychain-stored scoped API keys, certificate pinning, streaming native markdown, approvals with system notifications
  94. - **Memory & Recall** — Per-agent memory workspaces, embeddings-powered long-term memory, hybrid vector + full-text search, session persistence with auto-compaction, cross-session recall, Cursor-compatible project context, context-file safety scanning
  95. - **Managed Files** - Authenticated nested file management in Settings, with an agent-advertised host path and independent read-only-by-default mounts for Docker, Podman, and Apple Container sandboxes
  96. - **Safer Agent Editing** — Automatic checkpoints before built-in skill and memory mutations, restore tooling, session branching
  97. - **Extensibility** — MCP servers (stdio + HTTP/SSE), skill system, 15 lifecycle hook events with circuit breaker, destructive command guard
  98. - **Agent Client Protocol** — drives external ACP agents (`codex-acp`, `claude-agent-acp`, Cursor), and serves Moltis to ACP clients over stdio via `moltis acp`
  99. - **First Run** — Opens onboarding in your browser with the setup code pre-filled, serves certificate-free `http://localhost`, offers once to trust a name-constrained local CA for LAN HTTPS, and pins the web UI URL below the terminal logs (with an `ssh -L` hint over SSH)
  100. - **Security** — Encryption-at-rest vault (XChaCha20-Poly1305 + Argon2id), password + passkey + API key auth, sandbox isolation, SSRF/CSWSH protection
  101. - **Operations** — Cron scheduling, durable local CalDAV, Gmail, Himalaya email, and reusable Slack/Discord/Matrix/Teams message datasets, provider-specific read-only agent tools, fast full-text search, JSONL/Markdown projections, agent instrumentation (Langfuse for LLM traces, OTLP for Grafana/Datadog), Prometheus metrics, cloud deploy (Fly.io, DigitalOcean), Tailscale integration, managed SSH deploy keys, host-pinned remote targets, live tool inventory in Settings, and CLI/web remote-exec doctor flows
  102. ## How It Works
  103. Moltis is a **local-first persistent agent server** — a single Rust binary that
  104. sits between you and multiple LLM providers, keeps durable session state, and
  105. can meet you across channels without handing your data to a cloud relay.
  106. ```
  107. ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
  108. │ Web UI │ │ Telegram │ │ Discord │
  109. └──────┬──────┘ └──────┬──────┘ └──────┬──────┘
  110. │ │ │
  111. └────────┬───────┴────────┬───────┘
  112. │ WebSocket │
  113. ▼ ▼
  114. ┌─────────────────────────────────┐
  115. │ Gateway Server │
  116. │ (Axum · HTTP · WS · Auth) │
  117. ├─────────────────────────────────┤
  118. │ Chat Service │
  119. │ ┌───────────┐ ┌─────────────┐ │
  120. │ │ Agent │ │ Tool │ │
  121. │ │ Runner │◄┤ Registry │ │
  122. │ └─────┬─────┘ └─────────────┘ │
  123. │ │ │
  124. │ ┌─────▼─────────────────────┐ │
  125. │ │ Provider Registry │ │
  126. │ │ Multiple providers │ │
  127. │ │ (Codex · Copilot · Local)│ │
  128. │ └───────────────────────────┘ │
  129. ├─────────────────────────────────┤
  130. │ Sessions │ Memory │ Hooks │
  131. │ (JSONL) │ (SQLite)│ (events) │
  132. └─────────────────────────────────┘
  133. │
  134. ┌───────▼───────┐
  135. │ Sandbox │
  136. │ Docker/Apple │
  137. │ Container │
  138. └───────────────┘
  139. ```
  140. See [Quickstart](https://docs.moltis.org/quickstart.html) for gateway startup, message flow, sessions, and memory details.
  141. ## Getting Started
  142. ### Build & Run
  143. Requires [just](https://github.com/casey/just) (command runner) and Node.js (for Tailwind CSS).
  144. ```bash
  145. git clone https://github.com/moltis-org/moltis.git
  146. cd moltis
  147. just build-css # Build Tailwind CSS for the web UI
  148. just build-release # Build in release mode
  149. cargo run --release --bin moltis
  150. ```
  151. For a full release build including WASM sandbox tools:
  152. ```bash
  153. just build-release-with-wasm # Builds WASM artifacts + release binary
  154. cargo run --release --bin moltis
  155. ```
  156. Open `https://moltis.localhost:3000`. On first run, a setup code is printed to
  157. the terminal — enter it in the web UI to set your password or register a passkey.
  158. Optional flags: `--config-dir /path/to/config --data-dir /path/to/data`
  159. ### Docker
  160. ```bash
  161. # Docker / OrbStack
  162. docker run -d \
  163. --name moltis \
  164. -p 13131:13131 \
  165. -p 13132:13132 \
  166. -p 1455:1455 \
  167. -v moltis-config:/home/moltis/.config/moltis \
  168. -v moltis-data:/home/moltis/.moltis \
  169. -v /var/run/docker.sock:/var/run/docker.sock \
  170. ghcr.io/moltis-org/moltis:latest
  171. ```
  172. Open `https://localhost:13131` and complete the setup. For unattended Docker
  173. deployments, set `MOLTIS_PASSWORD`, `MOLTIS_PROVIDER`, and `MOLTIS_API_KEY`
  174. before first boot to skip the setup wizard. See [Docker docs](https://docs.moltis.org/docker.html)
  175. for Podman, OrbStack, TLS trust, and persistence details.
  176. ### Cloud Deployment
  177. | Provider | Deploy |
  178. |----------|--------|
  179. | DigitalOcean | [![Deploy to DO](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/apps/new?repo=https://github.com/moltis-org/moltis/tree/main) |
  180. **Fly.io** (CLI):
  181. ```bash
  182. fly launch --image ghcr.io/moltis-org/moltis:latest
  183. fly secrets set MOLTIS_PASSWORD="your-password"
  184. ```
  185. All cloud configs use `--no-tls` because the provider handles TLS termination.
  186. See [Cloud Deploy docs](https://docs.moltis.org/cloud-deploy.html) for details.
  187. ## License
  188. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.