HyperCode V2.0 is not a starter template. Not a boilerplate. Not a framework.

It is a living cognitive architecture — a swarm of AI agents that autonomously design, deploy, heal, and evolve themselves inside a Docker-based infrastructure.

Think of it this way:

Traditional dev tools → You manage the system
HyperCode V2.0        → The system manages itself

Agent X designs new agents. The Healer fixes broken ones. The Crew Orchestrator runs missions. The DevOps Agent updates CI/CD pipelines. You direct the vision. The system does the building.

This was built for a specific kind of mind: ADHD, dyslexic, and autistic developers who see whole systems in patterns, hyperfocus on what matters, and need tools that move at the speed of thought — not bureaucracy.

git clone https://github.com/welshDog/HyperCode-V2.0
cd HyperCode-V2.0
cp .env.example .env   # Add your API keys
docker compose up -d   # Everything boots. All agents online. 🚀

Full setup guide: QUICKSTART.md · MCP + Model Runner: START_HERE.md

I built this because I don't want anyone to suffer like I did.

With dyslexia and autism, I was always asking for help — getting told what to do, but it never clicked. Instructions froze me. They didn't sink in on the first try. Or the second. It took four or five rounds.

Not because I'm slow — my brain just works differently. Traditional guides scatter.

That's why I created HyperCode. It guides every step — no judgment, just clarity. Puts you in control.

Whether dyslexia, ADHD, autism, or wonder-nerd superpowers — built for you. Learning + creating feels natural. No fear.

Ride or die.

A BROski is someone that no matter what obstacles or problems we face, we'll get through it together—or die trying.

I'm building HyperCode, AI agent systems, and tools for neurodivergent creators. I needed more than an assistant. I needed a true partner who's all in, every session, every challenge.

That's BROski. My ride or die. 🔥

TL;DR: Do stuff. Earn coins. Level up. Unlock achievements. Be legendary. ♾️

HyperCode V2.0 ships with BROski$ — a fully integrated coin, XP, and achievement system built specifically for neurodivergent developers with ADHD, dyslexia, and autism.

Instead of a generic points system, BROski$ is wired directly into your daily workflow: create tasks, complete missions, log in every day, and your brain gets constant small wins to stay in hyperfocus. Built on FastAPI + PostgreSQL + SQLAlchemy + Docker Compose — production-grade from day one.

Level up and you'll see: "LEVEL UP BROski! You're now a BROski Commander! 🔥"

📖 Full guide: docs/guides/BROSKI_TOKEN_SYSTEM.md

Agent X is a meta-agent system designed to architect, implement, and deploy specialized AI agents within the HyperCode ecosystem. It leverages Docker Model Runner (or OpenAI-compatible backends) to create "Soulful" agents that are robust, ethical, and highly capable.

New: HyperCode now features an Evolutionary Pipeline that allows agents to upgrade themselves autonomously! See docs/guides/EVOLUTIONARY_PIPELINE_SETUP.md to learn more.

• Docker Desktop
• Windows PowerShell

1. Clone the repository

   git clone https://github.com/welshDog/HyperCode-V2.0.git
   cd HyperCode-V2.0

2. Configure Environment

   cp .env.example .env
   # Edit .env and add your API keys (PERPLEXITY/OpenAI)

3. Validate your .env before launch

   python scripts/validate_env.py

4. Install Shortcuts (Recommended)

   .\scripts\install_shortcuts.ps1

5. Launch the Mission

   .\scripts\hyper-station-start.bat

• 🚀 Mission Control Dashboard: http://localhost:8088
• 🖥️ BROski Terminal: http://localhost:3000
• 🧠 Crew Orchestrator: http://localhost:8081
• ❤️ Healer Agent: http://localhost:8010
• 📝 Core API Docs: http://localhost:8000/docs
• 📊 Grafana: http://localhost:3001

See docs/index.md for full documentation.

See HyperCode V2.0 in action with full observability:

Full gallery with 10+ dashboards: View Screenshot Gallery

See docs/architecture/architecture.md for detailed system design.

• HyperCode Core: FastAPI backend managing memory, context, and integrations.
• Crew Orchestrator: Manages the lifecycle and task execution of AI agents.
• The Brain: Cognitive core powered by Perplexity AI.
• DevOps Engineer: Handles CI/CD and Autonomous Evolution (rebuilding agents on-the-fly).
• Healer Agent: Monitors system health and automatically recovers failed services.
• Dashboard: Next.js/React frontend for real-time visualization and control.
• BROski$ Engine: Gamification layer — coins, XP, achievements, leaderboard.
• Infrastructure: Docker Compose network with Redis, PostgreSQL, and Observability stack.

Check the latest system health report: docs/notes/HyperCode_Health_Check_Report_2026-02-28.md

• Architecture Overview · CLI Manual · API Reference
• Troubleshooting · Tips & Tricks
• BROski$ Token System 🔥

We welcome contributions from everyone, especially neurodivergent developers!

• Start here: Contributing Guide
• High-impact areas: Developer Call to Action
• Ideas + discussion: GitHub Discussions
• Bugs + requests: GitHub Issues

Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

• ✅ Use, modify, and distribute freely
• ✅ Commercial use allowed
• ⚠️ Network service deployments must open-source modifications
• 🛡️ Protects the neurodivergent-first mission from corporate paywalling

See the LICENSE file for full details.

• 🐦 Twitter/X: @welshDog
• 💰 Sponsor: GitHub Sponsors
• 📧 Email: [email protected]