Install and first run

KARMAX is a single Go binary and a config file. It keeps everything it knows in ~/.karmax/.

Build it

git clone https://github.com/MelloB1989/KARMAX.git
cd KARMAX
go build -o karmax ./cmd/karmax

Configure it

cp karmax.yaml.example karmax.yaml

The parts that matter on a first run:

karmax:
  data_dir: "~/.karmax"

ai:
  providers:
    anthropic:
      api_key: "${ANTHROPIC_API_KEY}"

agents:
  - id: "nexus"
    model: "claude-sonnet-5"
    provider: "anthropic"
    memory:
      namespace: "nexus"
    tools: [shell.exec, file.read, http.request, notify.send, claude_code.call]

Secrets go in .env beside the config, and ${NAME} in the yaml reads from it. Nothing secret needs to live in karmax.yaml itself.

Run it

./karmax start

Then, from another terminal:

karmax ask "what can you do?"
karmax integrations          # nothing connected yet

Keep it running

KARMAX is meant to be a daemon, so run it under your service manager rather than a terminal you will eventually close. On Linux with systemd:

# ~/.config/systemd/user/karmax.service
[Unit]
Description=KARMAX

[Service]
ExecStart=%h/code/KARMAX/karmax start
WorkingDirectory=%h/code/KARMAX
Restart=always
StandardOutput=append:%h/.karmax/karmax.log
StandardError=append:%h/.karmax/karmax.log

[Install]
WantedBy=default.target

systemctl --user enable --now karmax
loginctl enable-linger $USER   # so it survives logout

What you get on a first run

Four recipes are written into ~/.karmax/recipes/ and start working immediately: a morning news digest, a memory sync, a profile refresh and a daily briefing. They are ordinary files — read them, change them, delete them.

Existing files are never overwritten. If you edit tech-news.yaml, a restart will not quietly put the original back: a default is what you get when you have not decided, not something that overrules you once you have.

Connect something

WhatsApp, Slack, GitHub, Notion.

Automate something

Your first recipe.

Get Started

KARMAX

The Karma Suite packages

Build it

Configure it

Run it

Keep it running

What you get on a first run

Next

Connect something

Automate something

​Build it

​Configure it

​Run it

​Keep it running

​What you get on a first run

​Next

Connect something

Automate something

Build it

Configure it

Run it

Keep it running

What you get on a first run

Next