NomosNomos
GitHub
Open Source · MIT License

An AI Agent That Remembers Everything, Works Everywhere

Deploy an autonomous agent to Slack, Discord, Telegram, and WhatsApp with persistent memory, multi-agent teams, smart model routing, and 35+ skills. Self-hosted. Fully yours.

$ npx @project-nomos/nomos chat

Everything You Need in One Agent

Memory, channels, teams, routing, skills, and security — all built in, all open source.

Memory That Persists
Every conversation auto-indexed into pgvector. Recall anything from any session or channel, even weeks later.
6 Channel Integrations
Slack, Discord, Telegram, WhatsApp, iMessage, and web. Thin adapters, one unified agent runtime.
Agent Teams
Coordinator + parallel workers. Hand off complex tasks and get synthesized results from multiple agents.
Smart Model Routing
Route by complexity across any provider — cloud, local Ollama, or hybrid. Cut costs automatically.
5 API Providers
Anthropic, Vertex AI, OpenRouter, Ollama, or any custom endpoint. Run fully local or in the cloud.
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.
35+ Skills
Three-tier loading: bundled, personal, project. Create your own skills in minutes with YAML frontmatter.
Encrypted at Rest
AES-256-GCM for all API keys and integration tokens. Auto-key generation on first run.
Adaptive Memory
Extracts facts, preferences, and corrections from conversations. Builds a persistent user model.
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.

Up and Running in Minutes

From install to deployed agent in four steps.

01

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
02

Chat or Deploy

Use the CLI for interactive sessions, or run the daemon to connect Slack, Discord, Telegram, and more.

$ nomos daemon run
03

Memory Builds Automatically

Every conversation is chunked, embedded, and indexed. The agent recalls context across sessions and channels.

04

Scale with Teams

Prefix any message with /team to spawn parallel workers. Complex tasks get decomposed, executed, and synthesized.

$ /team analyze our Q4 metrics

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

Telegram

Available

Built on grammY with markdown rendering

WhatsApp

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

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

35+ 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

Ready to Deploy Your Agent?

Open source, self-hosted, MIT licensed. Star the repo, clone it, and start building.