# sogni-agent

Creative AI superpowers for all AI agent runtimes — Claude Code, Claude Desktop,
OpenClaw, Hermes Agent, Manus AI, and more. Powered by Sogni AI's decentralized
GPU network.

## Install (pick the integration that matches your environment)

```bash
# MCP server (Claude Code)
claude mcp add sogni -- npx -y -p @sogni-ai/sogni-agent sogni-agent-mcp

# OpenClaw plugin
openclaw plugins install sogni-agent

# Hermes Agent / Manus / other agent frameworks
# Point the agent at https://github.com/Sogni-AI/sogni-agent — use SKILL.md as
# the behavior source and invoke the CLI/MCP server.

# Standalone Node CLI
npm install -g @sogni-ai/sogni-agent
```

## Configure Sogni credentials

Once-only setup, used by every integration above:

```bash
mkdir -p ~/.config/sogni
cat > ~/.config/sogni/credentials << 'EOF'
SOGNI_API_KEY=your_api_key
# or:
# SOGNI_USERNAME=your_username
# SOGNI_PASSWORD=your_password
EOF
chmod 600 ~/.config/sogni/credentials
```

You can also export `SOGNI_API_KEY`, or `SOGNI_USERNAME` + `SOGNI_PASSWORD`,
instead of writing the file. Sign up at https://app.sogni.ai/ if you do not
have an account.

## Repo

https://github.com/Sogni-AI/sogni-agent

## Key files

- `SKILL.md` — agent behavior and usage rules (load this into your agent)
- `openclaw.plugin.json` — OpenClaw plugin manifest and config schema
- `sogni-agent.mjs` — CLI used by the skill / MCP server
- `mcp-server.mjs` — MCP server entry point
