Quickstart

Get Moltis running in under 5 minutes.

1. Install

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

Or via Homebrew:

brew install moltis-org/tap/moltis

2. Start

moltis

You’ll see output like:

🚀 Moltis gateway starting...
🌐 Open http://localhost:13131 in your browser

3. Configure a Provider

You need an LLM provider configured to chat. The fastest options:

Option A: API Key (Anthropic, OpenAI, Gemini, etc.)

1. Set an API key as an environment variable and restart Moltis:

   export ANTHROPIC_API_KEY="sk-ant-..."   # Anthropic
   export OPENAI_API_KEY="sk-..."          # OpenAI
   export GEMINI_API_KEY="..."             # Google Gemini
   

2. Models appear automatically in the model picker.

Or configure via the web UI: Settings → Providers → enter your API key.

Option B: OAuth (Codex / Copilot)

1. In Moltis, go to Settings → Providers
2. Click OpenAI Codex or GitHub Copilot → Connect
3. Complete the OAuth flow

Option C: Local LLM (Offline)

1. In Moltis, go to Settings → Providers
2. Click Local LLM
3. Choose a model and save

See Providers for the full list of supported providers.

4. Chat!

Go to the Chat tab and start a conversation:

You: Write a Python function to check if a number is prime

Agent: Here's a Python function to check if a number is prime:

def is_prime(n):
    if n < 2:
        return False
    for i in range(2, int(n ** 0.5) + 1):
        if n % i == 0:
            return False
    return True

What’s Next?

Enable Tool Use

Moltis can execute code, browse the web, and more. Tools are enabled by default with sandbox protection.

Try:

You: Create a hello.py file that prints "Hello, World!" and run it

Connect Telegram

Chat with your agent from anywhere:

1. Create a bot via @BotFather
2. Copy the bot token
3. In Moltis: Settings → Telegram → Enter token → Save
4. Message your bot!

Connect Discord

1. Create a bot in the Discord Developer Portal
2. Enable Message Content Intent and copy the bot token
3. In Moltis: Settings → Channels → Connect Discord → Enter token → Connect
4. Invite the bot to your server and @mention it!

→ Full Discord setup guide

Add MCP Servers

Extend capabilities with MCP servers:

# In moltis.toml
[mcp]
[mcp.servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_TOKEN = "ghp_..." }

Set Up Memory

Enable long-term memory for context across sessions:

# In moltis.toml
[memory]
provider = "openai"
model = "text-embedding-3-small"

Add knowledge by placing Markdown files in ~/.moltis/memory/.

Useful Commands

File Locations

Getting Help

• Documentation: docs.moltis.org
• GitHub Issues: github.com/moltis-org/moltis/issues
• Discussions: github.com/moltis-org/moltis/discussions