moltis

<div align="center">

<a href="https://moltis.org"><img src="https://raw.githubusercontent.com/moltis-org/moltis/main/website/favicon.svg" alt="Moltis" width="64"></a>

# Moltis — Rust में एक सुरक्षित, स्थायी व्यक्तिगत एजेंट सर्वर

एक ही बाइनरी — सैंडबॉक्स्ड, सुरक्षित, आपका अपना।

[![CI](https://github.com/moltis-org/moltis/actions/workflows/ci.yml/badge.svg)](https://github.com/moltis-org/moltis/actions/workflows/ci.yml)
[![codecov](https://codecov.io/gh/moltis-org/moltis/graph/badge.svg)](https://codecov.io/gh/moltis-org/moltis)
[![CodSpeed](https://img.shields.io/endpoint?url=https://codspeed.io/badge.json&style=flat&label=CodSpeed)](https://codspeed.io/moltis-org/moltis)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Rust](https://img.shields.io/badge/Rust-1.91+-orange.svg)](https://www.rust-lang.org)
[![Discord](https://img.shields.io/discord/1469505370169933837?color=5865F2&label=Discord&logo=discord&logoColor=white)](https://discord.gg/XnmrepsXp5)

[इंस्टॉलेशन](#installation) • [तुलना](#comparison) • [आर्किटेक्चर](#architecture--crate-map) • [सुरक्षा](#security) • [विशेषताएँ](#features) • [यह कैसे काम करता है](#how-it-works) • [योगदान](https://github.com/moltis-org/moltis/blob/main/CONTRIBUTING.md)

</div>

---

Moltis हाल ही में [Hacker News के फ्रंट पेज](https://news.ycombinator.com/item?id=46993587) पर पहुँचा है। किसी भी तरह की परेशानी के लिए कृपया [एक issue खोलें](https://github.com/moltis-org/moltis/issues)। मेरा ध्यान Moltis को उत्कृष्ट बनाने पर है।

**डिज़ाइन से सुरक्षित** — आपकी कुंजियाँ कभी आपकी मशीन नहीं छोड़तीं। हर कमांड एक सैंडबॉक्स्ड कंटेनर में चलता है, कभी भी आपके होस्ट पर नहीं।

**आपका हार्डवेयर** — Mac Mini, Raspberry Pi, या आपके स्वामित्व वाले किसी भी सर्वर पर चलता है। एक Rust बाइनरी, न Node.js, न npm, न कोई रनटाइम।

**पूर्ण-विशेषताओं वाला** — वॉइस, मेमोरी, क्रॉस-सेशन रिकॉल, स्वचालित एडिट चेकपॉइंट, शेड्यूलिंग, Telegram, Signal, Discord, ब्राउज़र ऑटोमेशन, MCP सर्वर, SSH या node-आधारित रिमोट exec, वेब UI में होस्ट पिनिंग के साथ प्रबंधित डिप्लॉय कुंजियाँ, एक लाइव Settings → Tools इन्वेंटरी, Cursor-संगत प्रोजेक्ट कॉन्टेक्स्ट, और कॉन्टेक्स्ट-फ़ाइल थ्रेट स्कैनिंग — सब कुछ अंतर्निहित। सप्लाई-चेन हमले का शिकार होने के लिए कोई प्लगइन मार्केटप्लेस नहीं।

**ऑडिट-योग्य** — एजेंट रनर और मॉडल इंटरफ़ेस लगभग 7.5K लाइनों में समाते हैं, और प्रोवाइडर अतिरिक्त ~19K लाइनों में। Rust वर्कस्पेस 59 मॉड्यूलर क्रेट्स में फैली लगभग 270K लाइनों का है जिन्हें आप स्वतंत्र रूप से ऑडिट कर सकते हैं, जिनमें टेस्ट वाली 470+ Rust फ़ाइलें हैं। Unsafe कोड FFI और प्रीकंपाइल्ड रनटाइम सीमाओं तक सीमित है, न कि कोर एजेंट लूप में।

## इंस्टॉलेशन

```bash
# 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
```

## तुलना

| | OpenClaw | Hermes Agent | **Moltis** |
|---|---|---|---|
| प्राथमिक स्टैक | TypeScript + Swift/Kotlin साथी ऐप्स | Python + TypeScript TUI/web सतहें | **Rust** |
| रनटाइम | Node.js + npm/pnpm/bun | Python + uv/pip, वैकल्पिक Node UI भाग | **एकल Rust बाइनरी** |
| स्थानीय चेकआउट आकार\* | ~1.1M ऐप LoC | ~152K ऐप LoC | **~270K Rust LoC** |
| आर्किटेक्चर | व्यापक गेटवे, चैनल, नोड, और ऐप इकोसिस्टम | लर्निंग लूप और रिसर्च टूलिंग के साथ CLI/गेटवे एजेंट | **मॉड्यूलर क्रेट्स के साथ स्थायी व्यक्तिगत एजेंट सर्वर** |
| क्रेट्स/मॉड्यूल | npm पैकेज, एक्सटेंशन, ऐप्स | Python पैकेज, प्लगइन, टूल, TUI | **59 Rust वर्कस्पेस क्रेट्स** |
| सैंडबॉक्स/बैकएंड | ऐप-स्तरीय अनुमतियाँ, ब्राउज़र/नोड टूल | Local, Docker, SSH, Daytona, Singularity, Modal | **Docker/Podman + Apple Container + WASM** |
| प्रमाणीकरण/पहुँच | पेयरिंग और स्थानीय गेटवे नियंत्रण | CLI और मैसेजिंग गेटवे सेटअप | **Password + Passkey + API keys + Vault** |
| वॉइस I/O | वॉइस वेक और टॉक मोड | वॉइस मेमो ट्रांसक्रिप्शन | **अंतर्निहित STT + TTS प्रदाता** |
| MCP | प्लगइन/इंटीग्रेशन समर्थन | MCP इंटीग्रेशन | **stdio + HTTP/SSE** |
| स्किल्स | बंडल्ड, प्रबंधित, और वर्कस्पेस स्किल्स | स्व-सुधारक स्किल्स और Skills Hub समर्थन | **बंडल्ड/वर्कस्पेस स्किल्स + स्वायत्त सुधार + OpenClaw आयात** |
| मेमोरी/RAG | प्लगइन-समर्थित मेमोरी और कॉन्टेक्स्ट इंजन | एजेंट-क्यूरेटेड मेमोरी, सत्र खोज, उपयोगकर्ता मॉडलिंग | **SQLite + FTS + वेक्टर मेमोरी** |

\* LoC `tokei` से मापा गया, `node_modules`, जनरेटेड बिल्ड आउटपुट, `dist`, और `target` को छोड़कर।

> [दस्तावेज़ों में पूरी तुलना →](https://docs.moltis.org/comparison.html)

## आर्किटेक्चर — क्रेट मैप

वर्तमान Rust वर्कस्पेस: 59 क्रेट्स में ~270K LoC। नीचे दी गई तालिका मुख्य क्रेट्स को भूमिका के अनुसार समूहित करती है ताकि आर्किटेक्चर स्कैन करने योग्य बना रहे।

**कोर रनटाइम**:

| क्रेट | LoC | भूमिका |
|-------|-----|------|
| `moltis-gateway` | 37.4K | HTTP/WS सर्वर, RPC, प्रमाणीकरण, स्टार्टअप वायरिंग |
| `moltis-tools` | 37.0K | टूल निष्पादन, सैंडबॉक्सिंग, WASM टूल |
| `moltis-providers` | 18.9K | LLM प्रदाता कार्यान्वयन |
| `moltis-agents` | 14.5K | एजेंट लूप, स्ट्रीमिंग, प्रॉम्प्ट असेंबली |
| `moltis-chat` | 14.2K | चैट इंजन, एजेंट ऑर्केस्ट्रेशन |
| `moltis-config` | 10.3K | कॉन्फ़िगरेशन, सत्यापन |
| `moltis-httpd` | 9.9K | HTTP सर्वर प्रिमिटिव और मिडलवेयर |
| `moltis` (CLI) | 4.7K | प्रवेश बिंदु, CLI कमांड |
| `moltis-sessions` | 3.5K | सत्र दृढ़ता |
| `moltis-common` | 1.5K | साझा उपयोगिताएँ |
| `moltis-service-traits` | 1.2K | साझा सेवा इंटरफ़ेस |
| `moltis-protocol` | 0.7K | वायर प्रोटोकॉल प्रकार |

**फ़ीचर और इंटीग्रेशन क्रेट्स**:

| श्रेणी | क्रेट्स | संयुक्त LoC |
|----------|--------|-------------|
| चैनल | `moltis-telegram`, `moltis-whatsapp`, `moltis-signal`, `moltis-discord`, `moltis-msteams`, `moltis-matrix`, `moltis-slack`, `moltis-nostr`, `moltis-channels` | 34.0K |
| वेब और API | `moltis-web`, `moltis-graphql`, `moltis-webhooks` | 10.8K |
| विस्तारशीलता | `moltis-mcp`, `moltis-mcp-agent-bridge`, `moltis-skills`, `moltis-plugins` | 11.5K |
| मेमोरी और कॉन्टेक्स्ट | `moltis-memory`, `moltis-qmd`, `moltis-code-index`, `moltis-projects` | 11.7K |
| वॉइस और ब्राउज़र | `moltis-voice`, `moltis-browser` | 9.2K |
| प्रमाणीकरण और सुरक्षा | `moltis-auth`, `moltis-oauth`, `moltis-vault`, `moltis-secret-store`, `moltis-network-filter`, `moltis-tls` | 8.5K |
| शेड्यूलिंग और ऑटोमेशन | `moltis-cron`, `moltis-caldav`, `moltis-auto-reply` | 4.7K |
| सेटअप और आयात | `moltis-provider-setup`, `moltis-openclaw-import`, `moltis-onboarding` | 11.7K |
| नेटिव और नोड होस्ट | `moltis-swift-bridge`, `moltis-node-host`, `moltis-courier` | 5.7K |
| WASM टूल | `moltis-wasm-precompile`, `moltis-wasm-calc`, `moltis-wasm-web-fetch`, `moltis-wasm-web-search` | 1.4K |
| सहायक क्रेट्स | `moltis-media`, `moltis-metrics`, `moltis-tailscale`, `moltis-routing`, `moltis-canvas`, `moltis-schema-export`, `benchmarks` | 2.1K |

सीमित उपकरणों (Raspberry Pi, आदि) के लिए `--no-default-features --features lightweight` का उपयोग करें।

## सुरक्षा

- **छोटी असुरक्षित सतह** — कोर एजेंट/गेटवे कोड सुरक्षित Rust में रहता है; असुरक्षित कोड केवल Swift FFI, स्थानीय मॉडल रैपर्स, और प्रीकंपाइल्ड WASM सीमाओं तक सीमित है
- **सैंडबॉक्स्ड निष्पादन** — Docker + Apple Container, प्रति-सत्र आइसोलेशन
- **सीक्रेट हैंडलिंग** — `secrecy::Secret`, ड्रॉप पर शून्यीकृत, टूल आउटपुट से रिडैक्टेड
- **प्रमाणीकरण** — पासवर्ड + पासकी (WebAuthn), दर-सीमित, प्रति-IP थ्रॉटल
- **SSRF सुरक्षा** — DNS-रिज़ॉल्व्ड, लूपबैक/प्राइवेट/लिंक-लोकल को ब्लॉक करता है
- **ओरिजिन सत्यापन** — क्रॉस-ओरिजिन WebSocket अपग्रेड को अस्वीकार करता है
- **हुक गेटिंग** — `BeforeToolCall` हुक किसी भी टूल इनवोकेशन का निरीक्षण/ब्लॉक कर सकते हैं
- **सप्लाई चेन अखंडता** — [आर्टिफैक्ट अटेस्टेशन](https://github.com/moltis-org/moltis/attestations), Sigstore कीलेस साइनिंग, GPG साइनिंग (YubiKey), SHA-256/SHA-512 चेकसम

विवरण के लिए [सुरक्षा आर्किटेक्चर](https://docs.moltis.org/security.html) देखें।
रिलीज़ को `gh attestation verify <artifact> -R moltis-org/moltis` से सत्यापित करें या [रिलीज़ सत्यापन](https://docs.moltis.org/release-verification.html) देखें।

## विशेषताएँ

- **रीज़निंग डिफ़ॉल्ट्स** - मॉडल-रहित और नए मुख्य सत्रों के लिए कॉन्फ़िगर करने योग्य डिफ़ॉल्ट थिंकिंग एफ़र्ट, प्रति-सत्र स्पष्ट Off या स्तर ओवरराइड के साथ
- **AI गेटवे** — बहु-प्रदाता LLM समर्थन (OpenAI Codex, GitHub Copilot, Local), स्ट्रीमिंग प्रतिक्रियाएँ, सब-एजेंट डेलिगेशन के साथ एजेंट लूप, सत्र मोड, समानांतर टूल निष्पादन
- **संचार** — कमांड-पैलेट एजेंट प्रॉम्प्ट और Markdown कॉपी/एक्सपोर्ट के साथ Web UI, Telegram, Signal, Microsoft Teams, Discord, Slack (नेटिव लाइव टूल कार्ड के साथ), Nostr DM + NIP-29 ग्रुप चैट (Block के Buzz चैनल सहित), API एक्सेस, वॉइस I/O (8 TTS + 7 STT प्रदाता), पुश नोटिफिकेशन के साथ मोबाइल PWA
- **डेस्कटॉप ऐप** — नेटिव Rust/gpui क्लाइंट जो स्थानीय रूप से, HTTPS पर, या SSH टनल के माध्यम से चल रहे डेमॉन से जुड़ता है; कीचेन-संग्रहीत स्कोप्ड API कुंजियाँ, सर्टिफिकेट पिनिंग, स्ट्रीमिंग नेटिव markdown, सिस्टम नोटिफिकेशन के साथ अनुमोदन
- **मेमोरी और रिकॉल** — प्रति-एजेंट मेमोरी वर्कस्पेस, एम्बेडिंग्स-संचालित दीर्घकालिक मेमोरी, हाइब्रिड वेक्टर + फ़ुल-टेक्स्ट सर्च, ऑटो-कम्पैक्शन के साथ सत्र दृढ़ता, क्रॉस-सत्र रिकॉल, Cursor-संगत प्रोजेक्ट कॉन्टेक्स्ट, कॉन्टेक्स्ट-फ़ाइल सुरक्षा स्कैनिंग
- **प्रबंधित फ़ाइलें** - Settings में प्रमाणित नेस्टेड फ़ाइल प्रबंधन, एजेंट-विज्ञापित होस्ट पाथ और Docker, Podman, और Apple Container सैंडबॉक्स के लिए डिफ़ॉल्ट रूप से स्वतंत्र रीड-ओनली माउंट के साथ
- **सुरक्षित एजेंट एडिटिंग** — अंतर्निहित स्किल और मेमोरी म्यूटेशन से पहले स्वचालित चेकपॉइंट, रिस्टोर टूलिंग, सत्र ब्रांचिंग
- **विस्तारशीलता** — MCP सर्वर (stdio + HTTP/SSE), स्किल सिस्टम, सर्किट ब्रेकर के साथ 15 लाइफसाइकल हुक इवेंट, विनाशकारी कमांड गार्ड
- **एजेंट क्लाइंट प्रोटोकॉल** — बाहरी ACP एजेंट (`codex-acp`, `claude-agent-acp`, Cursor) को संचालित करता है, और `moltis acp` के माध्यम से stdio पर ACP क्लाइंट्स को Moltis प्रदान करता है
- **पहला रन** — आपके ब्राउज़र में सेटअप कोड पहले से भरा हुआ ऑनबोर्डिंग खोलता है, सर्टिफिकेट-रहित `http://localhost` प्रदान करता है, LAN HTTPS के लिए नाम-सीमित स्थानीय CA पर भरोसा करने का एक बार विकल्प देता है, और टर्मिनल लॉग के नीचे web UI URL पिन करता है (SSH पर `ssh -L` संकेत के साथ)
- **सुरक्षा** — एन्क्रिप्शन-एट-रेस्ट वॉल्ट (XChaCha20-Poly1305 + Argon2id), पासवर्ड + पासकी + API कुंजी प्रमाणीकरण, सैंडबॉक्स आइसोलेशन, SSRF/CSWSH सुरक्षा
- **संचालन** — Cron शेड्यूलिंग, टिकाऊ स्थानीय CalDAV, Gmail, Himalaya ईमेल, और पुन: प्रयोज्य Slack/Discord/Matrix/Teams संदेश डेटासेट, प्रदाता-विशिष्ट रीड-ओनली एजेंट टूल, तेज़ फ़ुल-टेक्स्ट सर्च, JSONL/Markdown प्रोजेक्शन, एजेंट इंस्ट्रुमेंटेशन (LLM ट्रेस के लिए Langfuse, Grafana/Datadog के लिए OTLP), Prometheus मेट्रिक्स, क्लाउड डिप्लॉय (Fly.io, DigitalOcean), Tailscale एकीकरण, प्रबंधित SSH डिप्लॉय कुंजियाँ, होस्ट-पिन्ड रिमोट टारगेट, Settings में लाइव टूल इन्वेंटरी, और CLI/web रिमोट-एक्ज़ेक डॉक्टर फ़्लो

## यह कैसे काम करता है

Moltis एक **लोकल-फ़र्स्ट पर्सिस्टेंट एजेंट सर्वर** है — एक एकल Rust बाइनरी जो
आपके और कई LLM प्रदाताओं के बीच बैठती है, टिकाऊ सत्र स्थिति रखती है, और
आपके डेटा को किसी क्लाउड रिले को सौंपे बिना कई चैनलों पर आपसे मिल सकती है।

```
┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│   Web UI    │  │  Telegram   │  │  Discord    │
└──────┬──────┘  └──────┬──────┘  └──────┬──────┘
       │                │                │
       └────────┬───────┴────────┬───────┘
                │   WebSocket    │
                ▼                ▼
        ┌─────────────────────────────────┐
        │          Gateway Server         │
        │   (Axum · HTTP · WS · Auth)     │
        ├─────────────────────────────────┤
        │        Chat Service             │
        │  ┌───────────┐ ┌─────────────┐  │
        │  │   Agent   │ │    Tool     │  │
        │  │   Runner  │◄┤   Registry  │  │
        │  └─────┬─────┘ └─────────────┘  │
        │        │                        │
        │  ┌─────▼─────────────────────┐  │
        │  │    Provider Registry      │  │
        │  │  Multiple providers       │  │
        │  │  (Codex · Copilot · Local)│  │
        │  └───────────────────────────┘  │
        ├─────────────────────────────────┤
        │  Sessions  │ Memory  │  Hooks   │
        │  (JSONL)   │ (SQLite)│ (events) │
        └─────────────────────────────────┘
                       │
               ┌───────▼───────┐
               │    Sandbox    │
               │ Docker/Apple  │
               │  Container    │
               └───────────────┘
```

विस्तृत जानकारी के लिए [Quickstart](https://docs.moltis.org/quickstart.html) देखें — गेटवे स्टार्टअप, संदेश प्रवाह, सत्र और मेमोरी।

## शुरुआत करना

### बिल्ड और रन

आवश्यक है [just](https://github.com/casey/just) (कमांड रनर) और Node.js (Tailwind CSS के लिए)।

```bash
git clone https://github.com/moltis-org/moltis.git
cd moltis
just build-css                  # Build Tailwind CSS for the web UI
just build-release              # Build in release mode
cargo run --release --bin moltis
```

पूर्ण रिलीज़ बिल्ड के लिए जिसमें WASM सैंडबॉक्स टूल्स शामिल हैं:

```bash
just build-release-with-wasm    # Builds WASM artifacts + release binary
cargo run --release --bin moltis
```

`https://moltis.localhost:3000` खोलें। पहली बार चलाने पर, टर्मिनल पर एक सेटअप कोड प्रिंट होता है — अपना पासवर्ड सेट करने या पासकी रजिस्टर करने के लिए इसे वेब UI में दर्ज करें।

वैकल्पिक फ़्लैग: `--config-dir /path/to/config --data-dir /path/to/data`

### Docker

```bash
# Docker / OrbStack
docker run -d \
  --name moltis \
  -p 13131:13131 \
  -p 13132:13132 \
  -p 1455:1455 \
  -v moltis-config:/home/moltis/.config/moltis \
  -v moltis-data:/home/moltis/.moltis \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/moltis-org/moltis:latest
```

`https://localhost:13131` खोलें और सेटअप पूरा करें। बिना निगरानी वाले Docker
परिनियोजनों के लिए, सेटअप विज़ार्ड को छोड़ने हेतु पहले बूट से पहले `MOLTIS_PASSWORD`, `MOLTIS_PROVIDER`, और `MOLTIS_API_KEY`
सेट करें। Podman, OrbStack, TLS ट्रस्ट, और स्थायित्व विवरण के लिए [Docker दस्तावेज़](https://docs.moltis.org/docker.html)
देखें।

### क्लाउड परिनियोजन

| प्रदाता | परिनियोजित करें |
|----------|--------|
| 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) |

**Fly.io** (CLI):

```bash
fly launch --image ghcr.io/moltis-org/moltis:latest
fly secrets set MOLTIS_PASSWORD="your-password"
```

सभी क्लाउड कॉन्फ़िगरेशन `--no-tls` का उपयोग करते हैं क्योंकि TLS टर्मिनेशन प्रदाता द्वारा संभाला जाता है।
विवरण के लिए [Cloud Deploy दस्तावेज़](https://docs.moltis.org/cloud-deploy.html) देखें।

## लाइसेंस

MIT