StarGraph

StarGraph es una herramienta de análisis y visualización de repositorios con estrella (stars) de GitHub. Utiliza IA para extraer perfiles técnicos, generar grafos de conocimiento y descubrir relaciones semánticas entre proyectos.

🚀 Inicio Rápido

Requisitos Previos

• Docker y Docker Compose
• API Keys: GitHub, Anthropic (Claude), OpenAI, Pinecone.

1. Configuración de Entorno

Crea un archivo .env en stargraph/backend/ basado en la configuración necesaria:

GITHUB_TOKEN=tu_token
GITHUB_USERNAME=tu_usuario
ANTHROPIC_API_KEY=tu_key
OPENAI_API_KEY=tu_key
PINECONE_API_KEY=tu_key
PINECONE_INDEX_NAME=stargraph
DATABASE_URL=postgresql+asyncpg://stargraph:stargraph@localhost:5432/stargraph
REDIS_URL=redis://localhost:6379/0

2. Levantar Infraestructura

docker-compose up -d

3. Preparar el Backend

cd stargraph/backend
pip install -r requirements.txt
alembic upgrade head

4. Iniciar Ingestión (Opcional - se puede hacer desde la UI)

python -m app.worker.cli --full

5. Iniciar Backend (FastAPI)

uvicorn app.main:app --reload --port 8000

6. Iniciar Frontend (Next.js)

cd stargraph/frontend
npm install
npm run dev

Accede a http://localhost:3000

🛠 Arquitectura

• Ingestion Pipeline: Python, Claude Haiku/Sonnet, OpenAI Embeddings, Pinecone.
• Backend: FastAPI, SQLAlchemy, Redis (Caché), SSE para Streaming.
• Frontend: Next.js 15, Tailwind CSS, shadcn/ui, Cytoscape.js para visualización de grafos.

📂 Estructura del Proyecto

• /backend: API de FastAPI y lógica de procesamiento de IA.
• /frontend: Aplicación web interactiva.
• /superpowers: Documentación de diseño y planes de ejecución.
• /docs/OPERATIONS.md: Setup operativo de Obsidian, Sentry, cron, webhooks, CI/CD.

🔗 Integraciones opcionales

• Obsidian bidireccional — exporta repos como notas y trae tus anotaciones al RAG. Ver docs/OPERATIONS.md.
• Sentry — observability opcional. Ver docs/OPERATIONS.md.
• Sync recurrente — vía cron del SO o sidecar Docker. Ver docs/OPERATIONS.md.