Cypher

Cypher is a real-time sports intelligence workflow platform for media and content operators.

Why this exists

• Most sports workflows rely on fragmented sources and manual synthesis.
• This project centralizes signal ingestion, structured analysis, and operator-ready outputs in one system.
• The goal is faster, higher-confidence editorial decisions under real time pressure.

What it does

• Ingests multi-source sports signals (scores, odds, injuries, news, social context).
• Runs deterministic and AI-assisted analysis passes to generate editorially useful angles.
• Serves a frontend designed for fast review, filtering, and workflow handoff.

Architecture

• server.py - primary backend entrypoint for API and orchestration.
• gtd/ - analysis engines, source adapters, and workflow logic.
• web/api/ - API-specific routes and backend helpers.
• web/frontend/ - React + TypeScript + Vite product interface.
• tests/ - backend validation and regression checks.

Current state

• Functional ingestion and analysis pipeline with modular source adapters.
• UI flows for feed review, card inspection, and operator-driven filtering.
• Public-facing repository hardened for safe external review.

Contribution focus

• Product architecture and operator workflow design.
• Frontend implementation for interaction patterns, state behavior, and UX iteration.
• Backend contribution support across API contracts, analysis shaping, and reliability guardrails.

Local development

Backend:

cd web
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 ../server.py

Frontend:

cd web/frontend
npm install
npm run dev

Environment setup:

• Use .env.example as the source of required variables.
• Do not commit real keys or credentials.

Documentation

• Public docs index: docs/README.md
• Public API reference: docs/API.md

Repo policy

• Contribution guide: CONTRIBUTING.md
• Security reporting: SECURITY.md