Acopia

Motor de optimización de despacho para una planta solar con batería (PV-BESS) en el mercado eléctrico chileno: pronostica generación PV y costo marginal (CMg) nodal y decide cuándo cargar/descargar para arbitrar el diferencial de CMg y rescatar energía que se vertería por congestión. Núcleo determinista predict-then-optimize (auditable); DRL como modo opcional medido. Capa MCP read-only para interrogar y simular el plan.

Arquitectura completa en SAD_Acopia_energia.md. Contexto de trabajo en CLAUDE.md.

Estado

Fase 1 — Despacho determinista (cerrada). Optimizador predict-then-optimize (cvxpy + HIGHS) que, dado un forecast, genera un plan de despacho factible y rentable, con ingreso auditable y API REST. Sobre el scaffolding de Fase 0 (capas, value objects, ModeloBateria puro, property-tests). Ver docs/AUDIT.md.

uv run uvicorn acopia.interfaces.rest.app:app --reload   # API en http://127.0.0.1:8000/docs

Related MCP server: PyPSA MCP

Estructura

src/acopia/
├── domain/          # núcleo puro (stdlib-only): value objects, entidades, servicios, puertos
├── application/     # casos de uso (fase 1+)
├── infrastructure/  # adaptadores: forecaster, solver, repos, gateways (fase 1+)
└── interfaces/      # REST (FastAPI) y MCP (FastMCP) (fase 1+)
tests/               # pytest + hypothesis

Desarrollo

Requiere Python 3.12+ y uv.

uv venv
uv pip install -e ".[dev]"

uv run ruff check .          # lint
uv run mypy                  # tipado estricto
uv run lint-imports          # fronteras de arquitectura (import-linter)
uv run pytest                # tests

Base de datos (TimescaleDB) para fases posteriores:

docker compose up -d db