The Autonomous AI Coding Agent

Landing Page | Built by Nishant Unavane

Custom-PI is a self-evolving autonomous AI coding agent with persistent knowledge graph memory, multi-agent DAG swarm orchestration, free AI image generation, and full social media automation. Built on the Pi Coding Agent.

AI coding assistants were used in the development of Custom-PI.

---

1. Key Features

Feature	Description
Free AI Image Generation	Generate 4 images via Pollinations.ai — Flux, GPT Image, Seedream models. Zero cost, no API key needed.
Social Media Automation	Post to Twitter/X, Reddit, Bluesky, Discord, Telegram with full browser automation and persistent login.
Knowledge Graph Memory	SQLite-backed triplet store (Subject→Predicate→Object) with confidence scoring, TTL-based pruning, and automatic LLM extraction.
DAG Swarm Orchestration	Multi-agent pipelines (Researcher → Writer → Publisher) running in parallel — no single-agent dead-ends.
26+ Autonomous Subsystems	Event bus, state graph, goal decomposer, episodic memory, theory of mind, metacognition, initiative engine, self-healer, security autopilot, and more.
40+ Built-in Tools	Browser automation, LSP code intelligence, AST-grep, email (OAuth 2.0), encrypted vault, SSH, web search, image generation, and social posting.
Dual Dashboards	Fullscreen terminal TUI + real-time React web dashboard with canvas editor, document editor, voice chat, 3D avatar, and swarm commander.
Webhook Ingestion	Receive events from Sentry, Datadog, GitHub — LLM-parsed failure triplets with proactive triage.
Secure Sandbox	Enforced approval gates, AES-256-GCM encrypted vault, isolated plugin execution with resource limits.

---

2. Quick Start

npm install -g custom-pi

# For browser automation (social posting):
npx playwright install chromium

# Launch:
custom-pi          # Terminal dashboard
custom-pi-web      # Web dashboard at http://localhost:4321

---

3. Architecture

graph TB
    User[User / Goal] --> CEO[CEO Orchestrator]

    subgraph "Nervous System"
        EB[Event Bus<br/>pub/sub mesh]
        SG[State Graph<br/>SQLite property graph]
        HS[Hybrid Search<br/>BM25+Dense+Graph]
        DA[Background Daemon<br/>24/7 persistent]
    end

    subgraph "Cognition"
        GD[Goal Decomposer]
        EM[Episodic Memory]
        TM[Theory of Mind]
        MC[Metacognition]
    end

    subgraph "Perception"
        ES[Environment Sensor]
        WS[Web Sentience]
    end

    subgraph "Autonomy"
        IE[Initiative Engine]
        FA[Financial Autonomy]
        SH[Self-Healer]
        SA[Security Autopilot]
    end

    subgraph "Swarm Intelligence"
        HM[Hive Mind]
        ME[MCP Ecosystem]
    end

    subgraph "Execution"
        FG[Full-Stack Generator]
        DI[Database Intelligence]
    end

    subgraph "Self-Evolution"
        SM[Self-Modifier]
        CL[Continuous Learning]
    end

    CEO --> EB
    EB --> GD --> EM --> TM --> MC
    EB --> ES --> WS
    EB --> IE --> FA --> SH --> SA
    EB --> HM --> ME
    EB --> FG --> DI
    EB --> SM --> CL

Loading

All 26+ subsystems communicate through a typed event bus and persist state in a unified property graph database. See AGENTS.md for the complete reference.

---

4. Free Image Generation — In Action

Agent: generate_image(provider: "free", prompt: "futuristic cityscape cyberpunk", count: 4)
  → 4 images generated, saved to ~/.pi/assets/
  → User picks one in AssetSelector modal
  → Selected image attached to social post

Default provider is Pollinations.ai — no API key, no signup. Set provider: "designapi" with a DESIGN_API_KEY for Flux Pro, DALL-E 3, Recraft v3, and Ideogram.

---

5. Tool Arsenal (40+)

Media Synthesis

generate_image · request_asset_selection · text_to_speech · render_mermaid

Social & Broadcast

request_post_approval · post_to_twitter · post_to_reddit · post_to_bluesky · post_to_discord · post_to_telegram

Knowledge & Memory

memory_store · memory_search · memory_edit · vault_set · vault_get · vault_delete · vault_list · vault_import

Search & Web

web_search · web_fetch · internal_url

Browser & Shell

browser · bash · ssh_exec

Code Intelligence

lsp · ast_grep · hashline_edit

Integrations

github · send_email · plugin

Ascension (Autonomous)

initialize_ascension · shutdown_ascension · decompose_goal · long_term_plan · causal_analyze · create_tool

---

6. Local Setup

From source

git clone https://github.com/IamNishant51/Custom-PI.git
cd Custom-PI
npm install
npx playwright install chromium
npm start              # Terminal dashboard
npm run web            # Web dashboard

---

7. Testing

npm test               # Unit + integration tests (406+ tests)
npx tsc --noEmit       # TypeScript compliance

---

8. Contributing

Contributions are welcome! See CONTRIBUTING.md for setup instructions, code conventions, and the pull request process. This project also uses a Code of Conduct and has a security policy.

Look for issues tagged good first issue.

---

License

MIT — Free to use, modify, and distribute. See LICENSE.

---

Built by Nishant Unavane