# Agentbot

**Deploy AI workers. Build underground systems.**

<div align="center">

<img src="https://indigo-decent-condor-546.mypinata.cloud/ipfs/bafybeigkpl3kax3x5wpx4xyyfldhyq6hqcwlihz5ku4cxc4ltufow4osyi" alt="Factory AI" width="900" />

[![Runtime](https://img.shields.io/badge/runtime-OpenClaw_2026.4.26-EF6F2E)](https://github.com/OpenClaw/openclaw)
[![Website](https://img.shields.io/badge/site-agentbot.sh-black)](https://agentbot.sh)
[![Docs](https://img.shields.io/badge/docs-live-EF6F2E)](https://agentbot.sh/documentation)
[![Discord](https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/vTPG4vdV6D)

[**Website**](https://agentbot.sh) · [**Documentation**](https://agentbot.sh/documentation) · [**Discord**](https://discord.gg/vTPG4vdV6D) · [**Open Source Repo**](https://github.com/Eskyee/agentbot-opensource)

</div>

---

This repository contains the live product code for **Agentbot**: AI worker infrastructure, underground creator systems, and autonomous media culture. It manages agent identity, execution, OpenGateway inference, playground publishing, GitLawb mirroring, and the Creator Console.

Agentbot is not another generic AI platform. It is infrastructure for autonomous underground creator systems.

## Platform Direction

- **Factory AI Unified:** High-energy "Factory Orange" aesthetic (#EF6F2E).
- **Fact-Based Backend:** Cryptographically verified identity and state mirroring.
- **Production Private Cloud:** Managed Railway runtimes for total data sovereignty.
- **AI Gateway Mastery:** Ultra-performance inference via Vercel AI Gateway + MiMo V2 Pro.
- **Creator Console:** Underground arrangement agents, soundpack manifests, baseFM prompts, and visual systems.

## What Lives Here

- `web/`
  Next.js 16 app powering the Factory dashboard and APIs.
- `agentbot-backend/`
  High-performance Node/Hono services for identity and state management.
- `gateway/`
  Managed multi-platform communication bridge (x402 protocol).
- `mintlify-docs/`
  Docs source for the Factory protocol.
- `skills/`
  Managed skill library including Bitcoin, Liquid, and Social integrations.
- `soul/`
  Borg-7139 soul host and cognitive architecture logic.

## Production Surfaces

- **Main Site:** `https://agentbot.sh`
- **Ops Command Center:** `https://agentbot.sh/admin` (Live Data)
- **Agentbot Coach:** `https://agentbot.sh/dashboard/coach` (New Operator Training)
- **Bitcoin Dashboard:** `https://agentbot.sh/dashboard/bitcoin` (Mainnet Active)
- **Fleet Control:** `https://agentbot.sh/dashboard/fleet`

## Technical Standards

- **Identity:** `SignatureGuard` enforced across all backend routes. `signedFetch` (DID-native) on frontend.
- **Infrastructure:** 100% Railway-native. Render references purged.
- **Model:** `xiaomi/mimo-v2-pro` (Factory Master) via Vercel AI Gateway.
- **Persistence:** SQL State + Gitlawb Fact Mirroring.
- **Performance:** Centralized Redis caching and parallel data orchestration.

## Local Development

### Web app

```bash
cd web
npm install
npm run build
npm run start
```

### Useful commands

```bash
npm run demo    # Local Agentbot demo at http://127.0.0.1:3007
npm run build   # Turbo-orchestrated full build
npm run dev     # Parallel dev environment
npm run test    # Identity and Logic verification
```

## Creator Toolkit

The underground creator layer lives at:

- `/creator-toolkit` — public toolkit, prompt library, producer agents, soundpack structure
- `/dashboard/creator` — Creator Console with the first Arrangement Agent
- `/api/creator-toolkit/arrangement` — deterministic Break Architect arrangement output
- `/api/creator-toolkit/producer-brief` — compiled agent prompts for model calls
- `/api/creator-toolkit/soundpack` — downloadable soundpack and marketplace manifest

## Key Documentation

- [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) — The Fact-Based Backend
- [docs/NEW_FEATURES_APRIL_2026.md](./docs/NEW_FEATURES_APRIL_2026.md) — Launch log
- [SECURITY.md](./SECURITY.md) — SignatureGuard and DID Protocol
- [PLATFORM_RULES.md](./PLATFORM_RULES.md) — Operational guidelines

## License

MIT
