{"id":48768619,"url":"https://github.com/buddhilive/carbo","last_synced_at":"2026-05-04T23:37:37.715Z","repository":{"id":199948760,"uuid":"704151778","full_name":"Buddhilive/carbo","owner":"Buddhilive","description":"Open-source Nx monorepo with Angular \u0026 NestJS for AI-powered SQL query generation.","archived":false,"fork":false,"pushed_at":"2026-03-02T18:45:35.000Z","size":1049,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-02T21:14:33.975Z","etag":null,"topics":["ai","angular","gemini","nestjs","nx"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Buddhilive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-12T16:35:49.000Z","updated_at":"2026-03-02T16:20:02.000Z","dependencies_parsed_at":"2023-10-14T17:42:41.001Z","dependency_job_id":"d97b9ef0-87b1-4f1b-86f0-7570921200de","html_url":"https://github.com/Buddhilive/carbo","commit_stats":null,"previous_names":["buddhilive/fireflow","buddhilive/carbo"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Buddhilive/carbo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buddhilive%2Fcarbo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buddhilive%2Fcarbo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buddhilive%2Fcarbo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buddhilive%2Fcarbo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Buddhilive","download_url":"https://codeload.github.com/Buddhilive/carbo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buddhilive%2Fcarbo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31746114,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T06:26:45.479Z","status":"ssl_error","status_checked_at":"2026-04-13T06:26:44.645Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","angular","gemini","nestjs","nx"],"created_at":"2026-04-13T09:02:44.715Z","updated_at":"2026-04-13T09:02:59.074Z","avatar_url":"https://github.com/Buddhilive.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Activity](https://img.shields.io/github/commit-activity/m/Buddhilive/carbo)](https://github.com/Buddhilive/carbo/pulse)\n![GitHub Release](https://img.shields.io/github/v/release/Buddhilive/carbo)\n![GitHub package.json version](https://img.shields.io/github/package-json/v/Buddhilive/carbo)\n![GitHub repo size](https://img.shields.io/github/repo-size/Buddhilive/carbo)\n\n# cARBo: The AI-Augmented Architecture Review Board\n\n**Carbo** is an intelligent architectural governance platform designed to turn the \"bottleneck\" of traditional Architecture Review Boards (ARBs) into a high-speed engine for better design.\n\n![Carbo](public/images/carbo-board-room.png)\n\nThe name **cARBo** (aka Carbo) isn’t just a catchy tech label; it is a literal manifestation of the app’s DNA. By nesting \"ARB\" (Architecture Review Board) directly in the center, the branding mirrors the product's function: placing rigorous architectural governance at the heart of the development lifecycle. The surrounding \"C\" and \"O\" represent the Council and Orchestration that wrap around the process, transforming a historically slow \"human-only\" bottleneck into a lean, carbon-fast, and AI-augmented experience.\n\nInstead of waiting weeks for a human committee to find a slot in their calendars, Carbo deploys a **Council of specialized AI Reviewers** to stress-test your proposals in seconds. Inspired by the \"LLM Council\" pattern, Carbo doesn't just give you a generic summary; it facilitates a rigorous, cross-functional debate between specialized agents to ensure every angle of your system—from security to cost—is interrogated.\n\n### Why Carbo?\n\nTraditional reviews often suffer from \"groupthink\" or missed details. Carbo solves this by assigning distinct, opinionated personas to every proposal:\n\n- **The Specialists:** Five autonomous agents (Security, Scalability, Cost, Operability, and Domain Architecture) evaluate your plan through their specific lens, looking for the \"rejection triggers\" humans might overlook.\n- **The Great Debate:** Carbo doesn't just aggregate notes. It forces the agents into a **Debate Round**, where they challenge each other's assumptions and refine their stances.\n- **The Chairman’s Verdict:** A final synthesis agent weighs the consensus and dissent to produce a formal, actionable **Architectural Decision Record (ADR)**.\n\n### The Tech Behind the Council\n\nBuilt on the cutting edge of the 2026 AI stack, Carbo leverages:\n\n- **LangGraph:** To orchestrate a complex state machine for parallel reasoning and agent communication.\n- **Groq:** Delivering near-instant inference so your full council review finishes before you can finish a tweet.\n- **Vercel AI SDK:** Providing a seamless, streaming UI experience that lets you watch the \"thought process\" of your reviewers in real-time.\n\n---\n\n**Carbo** takes the \"rubber stamp\" out of architecture reviews and replaces it with a rigorous, transparent, and lightning-fast council of experts.\n\n## Getting Started\n\nFollow these instructions to get a copy of the project up and running on your local machine for development and testing purposes.\n\n### Prerequisites\n\n- **Node.js**: Version 20.x or later.\n- **pnpm**: Version 9.x or later (recommended).\n- **Groq API Key**: You'll need an API key from [Groq](https://console.groq.com/) to power the AI reviewers.\n\n### Installation\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/Buddhilive/carbo.git\n   cd carbo\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   pnpm install\n   ```\n\n### Configuration\n\nCreate a `.env` file in the root directory and add your environment variables:\n\n```env\nGROQ_API_KEY=your_groq_api_key_here\nDATABASE_URL=\"file:./dev.db\"\n```\n\n### Database Setup\n\nCarbo uses **Prisma** with **SQLite** for local data persistence (storing review sessions and ADRs).\n\n1. **Generate the Prisma client:**\n\n   ```bash\n   pnpm db:generate\n   ```\n\n2. **Initialize the database:**\n   ```bash\n   pnpm db:push\n   ```\n   _Note: This will create a `dev.db` file in your project root._\n\n### Running the Application\n\n1. **Start the development server:**\n\n   ```bash\n   pnpm dev\n   ```\n\n2. **Open your browser:**\n   Navigate to [http://localhost:3000](http://localhost:3000) to see the application.\n\n### Key Scripts\n\n- `pnpm dev`: Runs the app in development mode.\n- `pnpm build`: Builds the app for production.\n- `pnpm start`: Runs the built app in production mode.\n- `pnpm db:studio`: Opens Prisma Studio to visualize and manage your local database.\n- `pnpm lint`: Runs ESLint to check for code quality issues.\n\n## Project Structure\n\n- `src/app`: Next.js App Router pages and API routes.\n- `src/lib/arb`: The core logic for the AI Council, including LangGraph definitions and agent personas.\n- `src/components/arb`: Specialized UI components for the ARB experience.\n- `src/components/ai-elements`: High-fidelity AI UI components.\n- `prisma/`: Database schema and migrations.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuddhilive%2Fcarbo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuddhilive%2Fcarbo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuddhilive%2Fcarbo/lists"}