Inicio rápido
0. Cadena de herramientas (mise)
Las versiones de Python, Node.js, pnpm y uv están fijadas en mise.toml y las instala mise, de modo que todas las máquinas usan la misma cadena de herramientas. Instala mise una sola vez:
| SO | Comando |
|---|---|
| Windows | winget install jdx.mise |
| macOS | brew install mise |
| Linux | Consulta la documentación de instalación |
Actívalo en tu shell (para bash/zsh/fish, consulta la documentación de activación; en Windows, añade (&mise activate pwsh) | Out-String | Invoke-Expression a tu $PROFILE de PowerShell) y, después, instala las herramientas desde la raíz del repositorio:
mise trust
mise install
En Windows, añade también el directorio de shims de mise (%LOCALAPPDATA%\mise\shims) a tu PATH, para que uv, pnpm y python se resuelvan incluso fuera de una shell activada.
¿No usas mise? Las versiones mínimas son Python 3.11+ y Node.js 20+, además de uv y pnpm instalados a mano.
1. Backend
El backend en sí solo necesita Python y uv; Node.js únicamente se usa para lanzar con npx los servidores MCP stdio publicados como paquetes npm, y la imagen de docker compose ya lo incluye.
cd backend
uv sync
cp .env.example .env
sed -i.bak 's/^SYSTEM_DEFAULT_LLM_API_KEY=.*/SYSTEM_DEFAULT_LLM_API_KEY=YOUR_API_KEY/' .env && rm .env.bak
uv run uvicorn main:app --host 0.0.0.0 --port 8000 --timeout-graceful-shutdown 30
.env.example usa Google Gemini de forma predeterminada, así que sustituye YOUR_API_KEY por tu propia clave. Para usar otro modelo o proveedor, consulta Configuración del LLM.
La API ya está disponible en http://localhost:8000.
2. Frontend
cd frontend
pnpm install
# Opcional: cp .env.local.example .env.local (solo hace falta si el backend no está en :8000)
pnpm build
pnpm start
Abre http://localhost:3000. Para usar otro puerto, consulta Changing the port en el README del frontend.