⚡ OPSCORD ⚡

Stop Firefighting. Start Understanding.

The AI-powered observability and incident intelligence platform for modern engineering teams.

---

🎯 Product Positioning

The Problem: When an outage occurs, your team is hit with an alert storm. Datadog screams about latency, Kubernetes restarts pods, and GitHub shows a recent merge. You spend 45 minutes manually cross-referencing dashboards to figure out why the system broke.

The Solution: OPSCORD acts as an intelligent webhook aggregator and causality engine. It ingests events from all your tools, feeds them into an AI engine, and gives you a single dashboard that tells you exactly what broke, why it broke, and how to fix it.

"The latency spike in Datadog was 98% likely caused by PR #284 merging 3 minutes ago."

🏗️ Architecture

graph LR
    A[External Webhooks<br/>GitHub · Sentry · Datadog] --> B(Ingestion Service<br/>Hono · Port 4001)
    B --> C{Redis Queue<br/>Upstash}
    C --> D[AI Engine<br/>Gemini · OpenRouter]
    D --> E[(PostgreSQL<br/>Supabase · Prisma)]
    E --> F[API Gateway<br/>Hono · Port 4000]
    F --> G[Dashboard<br/>Next.js · Port 3000]
    G -.-> H[Real-Time<br/>WebSockets]

Loading

🛠️ Tech Stack

Domain	Technologies
Frontend	Next.js 14 (App Router), React, Tailwind CSS, Framer Motion, Recharts, Zustand
Backend	Hono.js (API Gateway + Ingestion), Prisma ORM
Database	PostgreSQL (Supabase), Redis (Upstash)
AI	Google Gemini, OpenRouter
Auth	Clerk
DevOps	Turborepo, Docker, GitHub Actions, Vercel
Testing	Vitest, Husky, lint-staged, Prettier
Monitoring	Sentry, PostHog

✨ Core Features

• 🔌 Universal Event Ingestion — Accept webhooks from GitHub, Sentry, Datadog, Kubernetes, and custom sources
• 🧠 AI Causality Engine — LLM-powered root cause analysis across sequential event chains
• ⚡ Real-Time Command Center — WebSocket-powered dashboard with live infrastructure state
• 📊 Metrics Visualization — KPI cards, latency graphs, error rate trends via Recharts
• 🔔 Alert Timeline — Git-commit-style visualization for temporal event correlation
• 🛡️ Infrastructure Intelligence — Service health grid with resource utilization monitoring

---

🚀 Getting Started

Prerequisites

• Node.js 20+ (nvm use if you have .nvmrc)
• Docker Desktop (for local Postgres + Redis)

Setup

# 1. Clone
git clone https://github.com/probably-ABHINAV/OPSCORD.git
cd OPSCORD

# 2. Install
npm install

# 3. Environment
cp .env.example .env

# 4. Start infrastructure
docker compose up -d

# 5. Database
npx prisma db push --schema=packages/db/prisma/schema.prisma

# 6. Dev server
npm run dev

Service	URL
Dashboard	http://localhost:3000
API Gateway	http://localhost:4000
Ingestion	http://localhost:4001

Available Commands

npm run dev           # Start all services
npm run build         # Build all workspaces
npm run test          # Run all tests
npm run test:watch    # Tests in watch mode
npm run test:coverage # Tests with coverage
npm run lint          # Lint all workspaces
npm run type-check    # TypeScript check
npm run format        # Auto-format with Prettier
npm run validate      # Full quality gate (lint + type-check + test)

---

🤝 Contributing

We're proudly participating in GirlScript Summer of Code (GSSoC) 2026 🎉

Quick Start for Contributors

1. Read CONTRIBUTING.md — Rules, branch naming, commit format
2. Browse issues labeled good first issue or gssoc
3. Comment on an issue to get assigned
4. Fork → Branch → Code → npm run validate → PR

See GSSOC_ISSUES.md for 42 pre-scoped issues across all difficulty levels.

Contributor Tracks

Track	Focus
🔵 track:frontend	React, Next.js, Tailwind, UI
🟢 track:backend	Hono, API, Prisma, DB
🟣 track:devops	CI/CD, Docker, GitHub Actions
🟡 track:ai	Gemini, anomaly detection, NLP
🔵 track:docs	Documentation, guides
🔴 track:security	Auth, rate limiting, headers

---

🗺️ Roadmap

Q2 2026 — Foundation

• Monorepo architecture (Turborepo)
• Dashboard UI (Incidents, Metrics, Infrastructure)
• CI/CD pipelines (GitHub Actions — 5 quality gates)
• Testing infrastructure (Vitest, 9 tests)
• Pre-commit hooks (Husky + lint-staged)
• Docker multi-stage builds
• Clerk authentication integration
• Real-time WebSocket events

Q3 2026 — Intelligence

• AI incident summarization (Gemini)
• Anomaly detection engine
• GitHub/Sentry/Datadog webhook parsers
• Redis event queue (BullMQ)
• Command palette (Cmd+K)

Q4 2026 — Scale

• Custom dashboard widgets
• Multi-org RBAC
• Slack/Discord notifications
• Public API with rate limiting
• Playwright E2E tests

---

👑 Maintainers

• Abhinav — Creator & Lead Maintainer — @probably-ABHINAV

✨ Contributors

Thanks to these amazing people! (emoji key)

Abhinav 💻 📖 🚇 🚧 📆

This project follows the all-contributors specification. Contributions of any kind welcome!

🌐 Community

• Discord: Join the OPSCORD Server
• Twitter/X: @opscord_ai
• Discussions: GitHub Discussions

Please read our CODE_OF_CONDUCT.md for community rules.

---

Built with ⚡ by the OPSCORD Community.

## Troubleshooting

npm not recognized

Install Node.js from: https://nodejs.org/

Git not recognized

Install Git from: https://git-scm.com/download/win

PowerShell blocks npm

Use Command Prompt instead of PowerShell.

Prisma client error

If you get:

@prisma/client did not initialize yet

the Prisma setup steps may be missing or incomplete.