Does nod use paid AI services?

Can use OpenAI, Anthropic, Google Gemini, OpenRouter, Azure OpenAI, DeepSeek, Groq, Mistral, Together AI or xAI. Its settings have keys for these paid APIs. Its README says whether one is required.

Is nod still maintained?

Yes, active. Last change today. Latest release nod-v0.6.2, today.

New, little track record. 346 stars, 2 months old, by an organization. Look at the code and the owner before running it.

gitmanual

Reading the repo

Opening the box…

How to install on Linux

n8n-io/nod

Open source personal agent with its own computer. It chases invoices, preps your calls and cancels trials on real websites, and asks before it acts. Runs on your machine with the model you choose. By n8n.

Node.jsVite#agents#ai-agent#ai-assistant#anthropic

Before you start

Is it free?: YesOpen source (Apache-2.0).
Paid AI services?: Can use OpenAI, Anthropic, Google Gemini, OpenRouter, Azure OpenAI, DeepSeek, Groq, Mistral, Together AI or xAIIts settings have keys for these paid APIs. Its README says whether one is required.
Still maintained?: Yes, activeLast change today. Latest release nod-v0.6.2, today.
Can I trust it?: New, little track record346 stars, 2 months old, by an organization. Look at the code and the owner before running it.

Difficulty: Involved
Time: 30 min or more
Stars: ★ 346
Activity: Updated this month

Saved setup from 48 min ago

Will it work on Linux?

Yes, it runs on Linux

Apps are only published for macOS and Windows.
You'll build it yourself with Node.js.
It also needs PostgreSQL running (Docker handles this).

Your system

macOS Windows Linux

Start here

Website ↗nod.n8n.ioThe project's own site.

Heads-upBuilding it yourself? It also needs PostgreSQL and 93 settings in .env (50 secret).

No Linux app in the box

No ready-made Linux app or install command in nod-v0.6.2. There are apps for macOS and Windows.

Did you get it running?

No reports for Linux yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 13 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.

Parts list

1×Node.js >=24.21.0runtime
1×pnpm pnpm@10.34.5package manager
1×PostgreSQL service

93× settings in .env

PORT
NOD_HOST
NOD_DATA_ROOT
NOD_PRIVACY_NOTICE_FILE
NOD_POSTGRES_PASSWORDsecret
DATABASE_URL
DATABASE_POOL_MAX
LLM_PROVIDER
LLM_MODEL
OPENAI_API_KEYsecret
ANTHROPIC_API_KEYsecret
ANTHROPIC_WORKSPACE_ID
GEMINI_API_KEYsecret
OPENROUTER_API_KEYsecret
AWS_BEARER_TOKEN_BEDROCKsecret
GOOGLE_CLOUD_API_KEYsecret
AZURE_OPENAI_API_KEYsecret
ANT_LING_API_KEYsecret
BASETEN_API_KEYsecret
CEREBRAS_API_KEYsecret
CLOUDFLARE_WORKERS_AI_API_KEYsecret
CLOUDFLARE_AI_GATEWAY_API_KEYsecret
DEEPSEEK_API_KEYsecret
FIREWORKS_API_KEYsecret
GROQ_API_KEYsecret
HF_TOKENsecret
KIMI_API_KEYsecret
META_API_KEYsecret
MINIMAX_API_KEYsecret
MINIMAX_CN_API_KEYsecret
MISTRAL_API_KEYsecret
MOONSHOT_API_KEYsecret
MOONSHOT_CN_API_KEYsecret
NVIDIA_API_KEYsecret
OPENCODE_API_KEYsecret
OPENCODE_GO_API_KEYsecret
QWEN_TOKEN_PLAN_API_KEYsecret
QWEN_TOKEN_PLAN_CN_API_KEYsecret
QWEN_TOKEN_PLAN_INDIVIDUAL_API_KEYsecret
RADIUS_API_KEYsecret
TOGETHER_API_KEYsecret
AI_GATEWAY_API_KEYsecret
XAI_API_KEYsecret
XIAOMI_API_KEYsecret
XIAOMI_TOKEN_PLAN_AMS_API_KEYsecret
XIAOMI_TOKEN_PLAN_CN_API_KEYsecret
XIAOMI_TOKEN_PLAN_SGP_API_KEYsecret
ZAI_API_KEYsecret
ZAI_CODING_CN_API_KEYsecret
OPENAI_COMPATIBLE_API_KEYsecret
AWS_REGION
CLOUDFLARE_ACCOUNT_ID
CLOUDFLARE_GATEWAY_ID
AZURE_OPENAI_ENDPOINT
AZURE_OPENAI_MODEL
AZURE_OPENAI_DEPLOYMENT
OPENAI_COMPATIBLE_BASE_URL
NOD_COMPOSIO_PROXY_URL
TYPESAFE_API_KEYsecret
NOD_TRUST_MODEL

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/n8n-io/nod/badge.svg)](https://gitmanual.com/n8n-io/nod)

Good to know

Monorepo (workspaces) — install from the repo root.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: desktop/package.json, docs/package.json, evals/package.json

Details

License: Apache-2.0
Open issues: 16
Branch: main

package.json scripts (18)

devnode scripts/start.mjs
dev:servertsx watch src/server/index.ts
desktop:devnode desktop/scripts/build-ui.mjs && pnpm --dir desktop start
desktop:preparenode desktop/scripts/prepare-runtime.mjs
desktop:buildpnpm --dir desktop run build
desktop:windows:preparenode desktop/scripts/prepare-windows-runtime.mjs
desktop:windows:buildnode desktop/scripts/build-windows.mjs
desktop:testpnpm --dir desktop test
buildtsc --noEmit && vite build && node desktop/scripts/build-ui.mjs
checkpnpm run lint && pnpm run format:check
linttsc --noEmit && node scripts/check-architecture.mjs
testtsx --test tests/*.test.ts
startnode scripts/start.mjs --production
test:integrationnode scripts/test-integration.mjs
formatprettier --write .
format:checkprettier --check .
eval:voicetsx scripts/voice-eval.ts
eval:capabilitytsx evals/src/cli.ts

Files we read (13)

.env.example

.github/workflows/ci.yml

.github/workflows/dependabot-auto-merge.yml

.github/workflows/desktop-release.yml

.github/workflows/docs.yml

.github/workflows/evals.yml

.github/workflows/pr-title.yml

CONTRIBUTING.md

README.md

compose.yaml

deployment/self-host/.env.example

package.json

pnpm-workspace.yaml

1,407 files in the repo

Yes, it runs on Linux

Start here

No Linux app in the box

Did you get it running?

Still stuck? Get a written guide

More like nod that run on Linux