数字克隆

Prerequisites

• Node.js >= 22
• PostgreSQL with the pgvector extension
• One of: Anthropic API key, Google Cloud credentials (Vertex AI), OpenRouter API key, or a local Ollama instance

<details> <summary><strong>Database setup</strong></summary>

Nomos requires PostgreSQL with the pgvector extension. Choose whichever method suits your setup:

Option A: Homebrew (macOS)

PostgreSQL and pgvector are separate packages — you need both:

```bash

Docker Compose (includes database)

```bash git clone https://github.com/project-nomos/nomos.git cd nomos cp .env.example .env

Docker (standalone)

docker run -d --name nomos \
  -e DATABASE_URL=postgresql://nomos:nomos@host.docker.internal:5432/nomos \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  -p 8766:8766 -p 8765:8765 \
  ghcr.io/project-nomos/nomos:latest

1. Install PostgreSQL

brew install postgresql@17 brew services start postgresql@17

2. Install the pgvector extension

brew install pgvector

Pre-installed plugins (21)

14 first-party — agent-sdk-dev, code-review, code-simplifier, commit-commands, feature-dev, frontend-design, hookify, learning-output-style, math-olympiad, mcp-server-dev, plugin-dev, pr-review-toolkit, security-guidance, skill-creator

7 community — discord, github, imessage, linear, playwright, telegram, terraform

Plugins are fetched at install time from github.com/anthropics/claude-plugins-official (Apache 2.0) — not bundled in the repo. They're loaded into every SDK session — CLI, daemon, and team workers. See docs/plugins.md for the full list and architecture details.

---

Edit .env with your ANTHROPIC_API_KEY (or OPENROUTER_API_KEY)

docker compose up -d ```

The agent is accessible via gRPC on port 8766 and WebSocket on port 8765.

Note: Settings UI also starts automatically with the daemon

```

</details>

<details> <summary><strong>Browser Automation, Tasks, Hooks & More</strong></summary>

• Browser automation — Playwright-based with persistent sessions across tool calls
• Task state machine — lifecycle tracking with dependency graphs, auto-unblock, and cancellation
• Sleep & self-resume — agents pause and wake with a prompt for polling, monitoring, and async waits
• Plan mode — agent proposes structured plans for review before making changes
• LSP code intelligence — go-to-definition, find-references, hover, document symbols via TypeScript LSP
• Event hooks — command, HTTP, or prompt hooks on tool use, lifecycle, and compaction events
• Cost tracking — per-model pricing tiers, session cost summaries, usage breakdown in CLI and web dashboard
• Context visualization — see how your context window is used (system prompt, conversation, tools, memory, skills)
• Bash safety analysis — detects destructive commands, dangerous flags, elevated privileges before execution
• Proactive messaging — send outbound messages to any channel outside the reply flow
• Adaptive retry — exponential backoff with jitter, retry-after headers, persistent mode for daemon
• Tool result deduplication — SHA-256 hashing to deduplicate large tool results across turns
• Prompt cache break detection — logs warnings when system prompt changes would invalidate caches
• Digital marketing suite — Google Ads + Analytics via MCP
• Slack User Mode — act as you: draft responses for approval, then send as authenticated user
• Cron / scheduled tasks — run prompts on a schedule with configurable delivery modes
• 30+ slash commands — model switching, memory search, session management, and more

</details>

<details> <summary><strong>Configuration Reference</strong></summary>

Configuration is loaded with the following precedence: Database > environment variables > hardcoded defaults. Environment variables are loaded from ~/.nomos/.env (primary) and .env in the current directory (fallback). API keys and secrets are stored encrypted (AES-256-GCM) in the integrations table.

npm (GitHub Packages)

npm install -g @project-nomos/nomos --registry=https://npm.pkg.github.com

Channel Integrations

Each adapter is ~50-100 LOC. All agent logic is centralized in AgentRuntime. See docs/channels.md for env vars and setup, or the individual integration guides.

---

Plugins

Nomos supports plugins from the Claude Code ecosystem — extending the agent with additional skills, agents, hooks, and MCP servers. 21 plugins are pre-installed at build time; browse and install more from the Claude marketplace via CLI.

nomos plugin list                   # Show installed plugins (21 pre-installed)
nomos plugin available              # Browse all marketplace plugins
nomos plugin install <name>         # Install a plugin
nomos plugin remove <name>          # Remove a plugin

Channel integrations

Email is configured via the Settings UI (/integrations/email) or the integrations table (IMAP/SMTP host, port, credentials).

See .env.example for the complete list of all configuration options.

</details>

<details> <summary><strong>Slash Commands</strong></summary>

</details>

---