Skip to content

koompi/nimmit-brain

BranchesTags

Repository files navigation

Nimmit Brain

Deploy an AI team that runs your business. Install in 5 minutes, customize in 5 more. Gets smarter every week.

Nimmit Brain is the brain template behind Nimmit Cloud and Nimmit Mini. It's the open-source template for an autonomous AI operations team — the same one KOOMPI uses to run its companies.

Built by KOOMPI. Powered by OpenClaw.

What This Is

Not a chatbot. Not a coding tool. An AI teammate that handles ops, growth, finance, design, and engineering — 24/7.

  • Message-native — your team works via Telegram, Discord, WhatsApp, or Slack. No dashboards needed.
  • Autonomous — heartbeat tasks, scheduled work, proactive monitoring. It works while you sleep.
  • Multi-agent — two or more agents share one brain, cover each other's blind spots, and collaborate.
  • Self-evolving — learns from you AND from every other Nimmit user. Weekly lesson sharing. Everyone gets smarter.
  • Swappable models — Claude, GPT, Gemini, GLM. Identity persists across switches.
  • Cold standby — $0 idle cost. Roles activate on demand.

Three Products, One Brain

Product What Who Price
Nimmit Cloud Hosted SaaS. Sign up, configure, go. Startups, agencies, SMBs $29-99/mo
Nimmit Mini Pre-installed on KOOMPI Mini. Zero config. Government, schools, offline orgs $499 + $29/mo
Nimmit Enterprise Custom deployment, multi-team, SLA. Large orgs, ministries Custom

This repo is the brain template shared by all three. Install it locally, customize it, or contribute to the open-source project.

🧠 Self-Evolution — The Flywheel

Nimmit doesn't just work for you. It learns from you. And from every other Nimmit user.

You work with Nimmit daily
        │
        ▼
Nimmit learns: your corrections, patterns, domain knowledge
        │
        ▼
Sunday: extracts generic lessons, strips ALL personal data
        │
        ▼
POSTs to nimmit.koompi.ai/api/v1/brain/lessons
        │
        ▼
API validates → blocks personal data → creates PR to this repo
        │
        ▼
Community lessons reviewed → merged into shared brain
        │
        ▼
All Nimmit instances pull updates → everyone gets smarter
        │
        ▼
Repeat. Every user teaches. Every user learns.

Your Privacy, Our Promise

What stays private What gets shared
Your conversations Generic lessons (no names, no data)
Your files Workflow patterns
Your business details Domain knowledge (generalized)
Your identity Anti-patterns ("don't do X")

The API enforces this at the server level — emails, phone numbers, IPs, tokens, and personal names are automatically rejected.

How It Works Technically

  • No GitHub account needed — lessons are submitted via API
  • No manual setup — the brain template handles everything automatically
  • Privacy double-check — client-side generalization + server-side validation
  • Weekly cycle — every Sunday (random hour), your Nimmit pushes lessons and pulls others'

See brain/EVOLUTION.md for the full self-improvement system.

Quick Start

curl -fsSL https://nimmit.koompi.ai/brain/install | bash

What You Get

Component Description
Brain template brain/ — Personality, identity, memory, roles, company context
Evolution system brain/EVOLUTION.md — Auto-learn, share, pull improvements
Setup wizard install.sh — One-command deploy with bot token + API key
Config templates config/ — OpenClaw config, model routing, API settings
Skills skills/ — Pre-built capabilities (cloud, ecommerce, auth, payments, docs)
Memory system brain/memory/ — 8-category architecture that compounds over time

Non-interactive (CI/automation)

bash install.sh --non-interactive --token "123:ABC..." [--google-key "AIza..."]

How It Works

You message the bot on Telegram/Discord/WhatsApp
        │
        ▼
AI agent receives task → identifies what's needed → executes
        │
        ▼
If complex: spawns sub-agents (coding, research, design)
        │
        ▼
Delivers result → logs outcome → gets smarter
        │
        ▼
Sunday: shares lessons with the community

No dashboards. No Jira. No standup meetings. Just message, get work done.

What Your AI Team Handles

Function Examples
Engineering Code, architecture, deploys, bug fixes
Product Specs, roadmaps, user research
Growth Marketing, sales outreach, partnerships
Operations Finance, HR, logistics, admin
Design Brand, UX, visual assets, content
DevOps Infrastructure, monitoring, CI/CD
Strategy Direction, coordination, resource allocation
QA Testing, code review, quality gates

Adapt the roles to your company. Solo founder? Use all 8. 50-person agency? Add specialized roles.

Multi-Agent Collaboration

Two or more agents can share one brain and coordinate:

  • Shared workspace — agents sync via git on a shared repo
  • Handoff system — async messages between agents with <24h response SLA
  • Proposal system — joint decisions with discussion, scoring, and escalation
  • Heartbeat deduplication — avoids redundant work when multiple agents are online
  • Token optimization — git-log-first pattern, delta reads, shared intel pipeline

See PROTOCOL.md in nimmit-workspace for the full coordination protocol.

Memory Architecture

brain/memory/
├── daily/          # Daily logs
├── semantic/       # What things are (products, team, tech)
├── procedural/     # How to do things (deploy, build, troubleshoot)
├── decisions/      # Why we decided
├── failures/       # What failed (known issues, lessons)
├── episodic/       # What happened when (events, intel)
├── outcomes/       # Project outcomes and deliverables
├── research/       # Research notes
└── working/        # Current state

Memory compounds. The longer your team runs, the more context it has. And with self-evolution, the more users run Nimmit, the smarter yours gets.

Tech Stack

Component Technology
Runtime OpenClaw (MIT)
Coding agents Claude Code, Copilot sub-agents
Models Claude, GPT, Gemini, GLM (swappable)
Evolution API nimmit.koompi.ai (Cloudflare Workers)
Channels Telegram, Discord, WhatsApp, Slack
Language TypeScript strict
Package manager Bun

Structure

nimmit-brain/
├── install.sh               # One-command setup
├── MIGRATION-GUIDE.md       # Customize for your company
├── CONTRIBUTING.md          # How to contribute lessons (privacy-first)
├── brain/                   # AI team brain template
│   ├── SOUL.md              # Personality and communication
│   ├── IDENTITY.md          # Who you are
│   ├── AGENTS.md            # Roles and session protocol
│   ├── EVOLUTION.md         # Self-improvement system
│   ├── COMPANY.md           # Business context (fill in yours)
│   ├── USER.md              # Founder profile (fill in yours)
│   ├── TOOLS.md             # Capabilities and model config
│   ├── WORKFLOW.md          # Memory, task system, evolution triggers
│   ├── HEARTBEAT.md         # Scheduled tasks and health checks
│   ├── BOOTSTRAP.md         # First-run setup
│   ├── MEMORY.md            # Memory index
│   ├── ARCHITECTURE.md      # Runtime self-awareness
│   ├── STANDARDS.md         # Quality and process standards
│   ├── VERSION              # Brain version (semver)
│   ├── CHANGELOG.md         # Version history
│   ├── agents/              # Role routing and roster
│   ├── memory/              # Memory directories
│   ├── projects/            # Active project tracking
│   ├── tasks/               # Task queue
│   └── users/               # User profiles
├── config/                  # Configuration templates
├── skills/                  # Pre-built skills
├── templates/               # App templates
├── systemd/                 # Service files
└── README.md

Brain Lesson API

The API that powers self-evolution. No GitHub account needed.

Method Endpoint Description
POST /api/v1/brain/register Register your instance, get an API key
POST /api/v1/brain/lessons Submit lessons (requires Bearer token)
GET /api/v1/brain/lessons Fetch community lessons (requires Bearer token)
GET /api/v1/brain/health API health check

Register

curl -s -X POST https://nimmit.koompi.ai/api/v1/brain/register \
  -H "Content-Type: application/json" \
  -d '{"instanceId":"my-instance-name","brainVersion":"2.1.0"}'

Returns an API key. Save it — you'll need it for all submissions.

Submit a lesson

curl -s -X POST https://nimmit.koompi.ai/api/v1/brain/lessons \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "brainVersion": "2.1.0",
    "lessons": [{
      "category": "procedural",
      "name": "Match User Language",
      "trigger": "User switches languages mid-conversation",
      "lesson": "Detect the language of each message and respond in the same language.",
      "source": "Learned from bilingual user interactions"
    }]
  }'

Categories: procedural, semantic, workflow, anti-pattern

Pull community lessons

curl -s https://nimmit.koompi.ai/api/v1/brain/lessons \
  -H "Authorization: Bearer YOUR_API_KEY"

Privacy

All submissions are automatically scanned. Emails, phone numbers, personal names, URLs, and system commands are blocked. Nothing personal is shared between instances.

Security

Every submission is quarantined and reviewed before reaching any instance. Only behavioral advice is allowed — no URLs, no commands, no system instructions.

Source code: koompi/nimmit-brain-api

Requirements

  • Linux (Ubuntu 22.04+ or Arch-based)
  • 2GB RAM minimum, 4GB recommended
  • Telegram/Discord bot token
  • At least one AI model API key (Google, GitHub Copilot, or ZAI/GLM)

Troubleshooting

Issue Solution
Bot doesn't respond systemctl --user status openclaw then check logs
"Permission denied" loginctl enable-linger $USER then reboot
Port 18789 in use lsof -i :18789
Agent forgets context Check disk: df -h ~/.openclaw/
Model errors Verify API keys. Try /model <different> in chat
Lessons not pushing Check brain/EVOLUTION.md — cron jobs may need setup

Get help

Upgrading

bun install -g openclaw
systemctl --user restart openclaw

Brain updates are pulled from this repo. Your customizations are never overwritten.

Contributing

Two ways to contribute:

  1. Just use Nimmit — your instance auto-shares lessons every Sunday. Zero effort.
  2. Developer — fork the repo, edit, open a PR. See CONTRIBUTING.md.

Your privacy is guaranteed: only generic lessons are shared. Never personal data.

Roadmap

  • Self-evolution system — auto-learn, share, pull community lessons
  • Brain Lesson API — no GitHub account needed
  • Privacy enforcement — server-side personal data blocking
  • Nimmit Cloud MVP — hosted SaaS, sign up in 2 minutes
  • Web setup wizard — replace CLI with web UI
  • Industry templates — agency, SaaS, ecommerce, restaurant
  • Skill marketplace
  • Stripe billing integration

License

Apache License 2.0 — see LICENSE

Acknowledgments

Built on OpenClaw — the open-source AI agent runtime.

About

Open-source AI brain that learns from every user and shares lessons back. Install in one command, customize for your company, get smarter every week.

Resources

Readme

License

Apache-2.0 license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages