Nomos is a free, open source AI digital clone that learns who you are, acts on your behalf, remembers everything, and represents you across every platform. Deploy to iMessage, Slack, Discord, Telegram, WhatsApp, and more. Self-hosted on your infrastructure with 60+ skills.

Is Nomos free to use?

Yes. Nomos is completely free and open source under the MIT license. You self-host it on your own infrastructure with full control over your data. Bring any LLM provider — Anthropic, Vertex AI, OpenRouter, or Ollama.

What platforms does Nomos support?

Nomos represents you on iMessage, Slack, Discord, Telegram, WhatsApp, and Web/gRPC. Your digital clone is reachable from wherever you work, with Slack User Mode that sends messages as you — not as a bot.

How does Nomos learn who I am?

Nomos uses adaptive memory to extract your preferences, decisions, and communication style from every conversation. It builds a persistent model of you that deepens over time, with total recall across all channels and sessions.

Open Source · MIT License

Your AI Digital Clone

Learns who you are. Acts on your behalf. Remembers everything. Represents you across iMessage, Slack, Discord, Telegram, WhatsApp, and more. Multi-provider, self-hosted, and fully yours.

Get Started View on GitHub


$ npx @project-nomos/nomos chat

Everything Your Clone Needs

Adaptive learning, total recall, multi-provider routing, 60+ skills, multi-agent teams, and encryption — all built in, all open source.

Learns Who You Are

Adaptive memory extracts your preferences, decisions, and communication style. Builds a persistent model of you that deepens with every conversation.

Acts As You

Slack User Mode sends messages as the authenticated user — not as a bot. Drafts emails, manages your calendar, preps meetings, follows up. Autonomously.

Total Recall

Every conversation auto-indexed into pgvector. Ask about last week's discussion across any channel or session — it knows.

Represents You Everywhere

iMessage, Slack, Discord, Telegram, WhatsApp, and web. Your clone is reachable from wherever you work.

Multi-Provider

Anthropic, Vertex AI, OpenRouter, Ollama, or any custom endpoint. Cloud models, local models, or mix and match.

Smart Model Routing

Route by complexity across any provider — simple queries to fast models, complex to capable ones. Cut costs 5-10x automatically.

Multi-Agent Teams

Coordinator + parallel workers. Hand off complex tasks and get synthesized results from multiple agents.

Image & Video Generation

Gemini image + Veo video generation built in. Just ask conversationally — no configuration needed.

Web Dashboard

Next.js settings UI with setup wizard. Configure integrations, models, and permissions — no YAML editing.

60+ Skills

Gmail, Calendar, Drive, Docs, Sheets, document gen, browser automation, and more. Three-tier loading: bundled, personal, project.

Encrypted at Rest

AES-256-GCM for all API keys and integration tokens. Your clone stays on your infrastructure.

Self-Improvement

Nomos can analyze its own codebase, implement fixes, and open pull requests to itself — autonomously.

CLI / npx Interface

Run Nomos from the terminal with a single command. npx @project-nomos/nomos chat — no install required.

Browser Automation

Playwright-based interactive browser with persistent sessions. Navigate, click, type, screenshot — for login flows and scraping.

Task Orchestration

Task lifecycle tracking with dependency graphs, auto-unblock on completion, cycle detection, and abort-based cancellation.

LSP Code Intelligence

Go-to-definition, find-references, hover, and document symbols via TypeScript language server — built into the agent.

Sleep & Self-Resume

Agents pause and wake with a prompt. Poll deployments, wait for async operations, or monitor within a session.

Scheduled Tasks

Run agent prompts on a schedule — intervals, cron expressions, or one-time. Results delivered to any connected channel.

Proactive Messaging

The agent reaches out without being asked — urgent alerts, monitoring results, or scheduled task output to any channel.

Cost Tracking

Per-model pricing tiers, session cost summaries, and usage breakdown. Track spend across Haiku, Sonnet, and Opus in CLI and web dashboard.

Event Hooks

Extend the agent with command, HTTP, or prompt hooks. Trigger on tool use, session lifecycle, or compaction — exit code 2 blocks execution.

Bash Safety Analysis

Lightweight command analysis detects destructive operations, elevated privileges, and dangerous git commands before execution.

Magic Docs

Markdown files with a magic marker auto-update in the background when stale. Self-maintaining documentation powered by forked agents.

Context Visualization

See exactly how your context window is used — system prompt, conversation, tools, memory, skills — with color-coded bar chart and capacity warnings.

Auto-Dream Memory

Background memory consolidation triggered by time and turn count gates. Four-phase cleanup keeps your knowledge base fresh and accurate.

Session Persistence

Pick up any conversation exactly where you left off. Sessions auto-resume across CLI, daemon, and channels — no context lost.

gRPC & WebSocket API

Build custom clients on top of your clone. Bidirectional streaming via gRPC, plus legacy WebSocket support — mobile, web, or CLI.

Up and Running in Minutes

From install to deployed agent in four steps.

Install & Connect

One command to start. Connect your database, set an API key, and the setup wizard walks you through the rest.

$ npx @project-nomos/nomos chat

Deploy Your Clone

Run the daemon to connect Slack, Discord, Telegram, and more. Your clone is always on, always reachable.

$ nomos daemon start

It Learns Who You Are

Every conversation builds your clone's memory. Adaptive learning extracts your preferences, decisions, and communication style.

It Acts On Your Behalf

Draft emails, manage your calendar, prep meetings, follow up on action items — or hand off complex tasks to multi-agent teams.

$ /team analyze our Q4 metrics

Smart Model Selection

The Right Model for Every Message

Nomos analyzes each message and routes it to the best model based on complexity. Simple lookups go to fast models. Deep reasoning goes to premium ones. You set the providers — Nomos handles the rest.

Complexity-Based Routing

Simple questions go to fast, cheap models. Complex reasoning gets routed to premium models. Automatic — no rules to configure.

Cut Costs Automatically

Use powerful models only when needed. Route 80% of queries to lightweight models and save without sacrificing quality.

5 Providers, Any Model

Anthropic, Vertex AI, OpenRouter, Ollama, or custom endpoints. Mix cloud and local models in a single agent.


You: What time is it in Tokyo?
→ routed to gemini-flash · simple lookup
You: Analyze our Q4 revenue trends and suggest strategies
→ routed to claude-sonnet · complex reasoning
You: Generate an image of a mountain sunset
→ routed to gemini-pro · image generation
✓ 3 queries · 2 providers · 67% cost saved vs. premium-only

Deploy to 6 Platforms

One agent runtime, thin adapters. Messages from all channels flow into the same brain with the same memory.

Slack

Available

Socket Mode + User Mode with draft approval

Discord

Available

Full bot integration with streaming responses

Available

Built on grammY with markdown rendering

Available

Via Baileys — no business API needed

iMessage

macOS

macOS native — reads from Messages.app

Web / gRPC

Available

Connect any client via gRPC or WebSocket


Settings Dashboard
Primary Modelclaude-sonnet-4
Fast Modelgemini-flash
Smart RoutingEnabled
SlackConnected
DiscordConnected
TelegramPending
Skills Enabled28 / 35
EncryptionAES-256-GCM

Web Dashboard

Configure Everything from the Browser

No YAML files. No environment variables. The built-in Next.js dashboard gives you full control over models, integrations, skills, and permissions — with a setup wizard that gets you running in minutes.

Model & Provider Config

Switch models, set routing rules, and configure API keys — all from the UI.

Channel Integrations

Connect Slack, Discord, Telegram, and WhatsApp with guided setup. No config files.

Permissions & Safety

Control which skills are enabled, set content filters, and manage user access.

Personality & Behavior

Customize the agent's tone, system prompts, and response style per channel.

Setup Wizard

First-run wizard walks you through database, API keys, and channel setup step by step.

An Agent That Evolves Itself

Nomos has a built-in self-improvement skill. It can analyze its own codebase, implement changes, and open pull requests — all autonomously.

Clones a fresh copy — never modifies the running instance

Runs all checks: format, typecheck, lint, and tests

Opens a PR for your review with a clear summary

Just say "improve yourself" or "add tests for the chunker"


You:
Add edge case tests for the memory chunker
Nomos:
I'll analyze the chunker, write tests, and open a PR.
✓ Cloned repo to /tmp/nomos
✓ Analyzed src/memory/chunker.ts
✓ Added 6 edge case tests
✓ All 199 tests passing
✓ PR opened: #42

Advanced Agent Capabilities

Beyond chat — browser automation, task orchestration, code intelligence, hooks, auto-dream consolidation, and autonomous operations.

Interactive Browser

Playwright-based browser automation with persistent sessions. Navigate, click, type, screenshot, and execute JavaScript across multi-step workflows.

browser_navigatebrowser_clickbrowser_typebrowser_screenshot

Task Dependency Graph

Every operation tracked as a task with lifecycle states. Declare dependencies between tasks — they auto-start when blockers complete, with cycle detection.

task_statustask_kill

LSP Code Intelligence

TypeScript language server integration. Go-to-definition, find-references, hover for type info, and document symbols — without leaving the conversation.

lsp_go_to_definitionlsp_find_referenceslsp_hover

Plan Mode

For complex tasks, the agent proposes a structured plan with steps, affected files, and risk levels. Review and approve before any changes are made.

propose_plan

Sleep & Self-Resume

Agents pause execution for up to an hour and resume with a wake-up prompt. Perfect for polling deployments or waiting for async operations.

agent_sleep

Proactive Messaging

Send messages to your channels unprompted — urgent alerts, monitoring results, or scheduled task output. Routes through the daemon's channel manager.

proactive_send

Inter-Agent Messaging

Workers communicate via an in-memory message bus with priority levels during team execution. Share results or report blockers in real time.

send_worker_messagecheck_worker_messages

Verification Agent

After team workers finish, a read-only adversarial agent runs tests, build, and lint. Reports PASS, FAIL, or PARTIAL with details.

Memory Consolidation

Four-phase cleanup: prune stale chunks, merge near-duplicates by vector similarity, LLM-powered review via Haiku, and confidence decay.

memory_consolidate

Worktree Isolation

Team workers operate in isolated git worktrees to avoid conflicts. Auto-cleanup if no changes were made; preserved for review if changes exist.

Context Visualization

See exactly how your context window is being used — system prompt, conversation, tools, memory, and skills. Bar chart in CLI and web dashboard with capacity warnings.

Hook System

Event-driven extensibility via hooks.json. Command, HTTP webhook, and prompt hooks fire on tool use, session lifecycle, or compaction. Pattern matching with glob support.

Auto-Dream Consolidation

Background memory consolidation triggered by time and turn count gates. Four phases: Orient, Gather, Consolidate, Prune. Lock-file coordination prevents concurrent runs.

Adaptive Retry

Exponential backoff with jitter, retry-after header parsing, and 429/529 detection. Persistent mode for daemon retries indefinitely with abort signal support.

60+ Skills, Three-Tier Loading

Bundled skills get you started. Add personal skills at ~/.nomos/skills/ or project-specific ones at ./skills/. Create your own in minutes.

Productivity

Google CalendarGoogle DocsGoogle DriveGmailGoogle SheetsGoogle SlidesApple NotesApple RemindersDoc Co-authoringWeather

Communication

SlackDiscordTelegramWhatsAppDigital MarketingInternal Comms

Development

GitHubMCP BuilderWebapp TestingFrontend DesignSelf-ImproveSkill Creator

Creative

Image GenerationVideo GenerationAlgorithmic ArtBrand GuidelinesTheme FactoryCanvas Design

Documents

PDFDOCXPPTXXLSXWeb Artifacts Builder

Operations

Browser AutomationScheduled TasksCost TrackingBash SafetyMagic DocsAuto-Dream

Ready to Build Your Clone?

Open source, self-hosted, MIT licensed. Your AI digital clone — running on your infrastructure in minutes.

Get Started Star on GitHub