diegobeyl/backtesting
2
1# 馃殌 Inicio R谩pido - Backtesting App V2
2
3## 馃幆 Inicio con UN SOLO COMANDO (Recomendado)
4
5### Windows
6```powershell
7# 1. Ir a la carpeta
8cd C:\Users\Javier\Downloads\backtesting_app_v2
9
10# 2. Primera vez: Setup
11.\setup.ps1
12
13# 3. Iniciar TODO (API + Streamlit)
14.\start.ps1
15
16# 隆Listo! Se abrir谩 el navegador autom谩ticamente
17```
18
19**Otros comandos 煤tiles:**
20```powershell
21# Detener todo
22.\stop.ps1
23
24# Reiniciar todo
25.\restart.ps1
26
27# Iniciar sin abrir navegador
28.\start.ps1 -NoBrowser
29```
30
31---
32
33## 馃搵 Instalaci贸n Manual (Alternativa)
34
35### Windows
36```powershell
37# 1. Ir a la carpeta
38cd C:\Users\Javier\Downloads\backtesting_app_v2
39
40# 2. Ejecutar setup autom谩tico
41.\setup.ps1
42
43# 3. Activar entorno (si no lo hizo el script)
44.\venv\Scripts\Activate.ps1
45
46# 4. Iniciar API
47python api/main.py
48```
49
50En otra terminal:
51```powershell
52# 5. Iniciar Streamlit
53cd backtesting_app\backtesting_app
54streamlit run app.py
55```
56
57### Linux/Mac
58```bash
59# 1. Ir a la carpeta
60cd backtesting_app_v2
61
62# 2. Ejecutar setup
63chmod +x setup.sh
64./setup.sh
65
66# 3. Activar entorno
67source venv/bin/activate
68
69# 4. Iniciar API
70python api/main.py
71```
72
73En otra terminal:
74```bash
75# 5. Iniciar Streamlit
76cd backtesting_app/backtesting_app
77streamlit run app.py
78```
79
80## Docker (M谩s F谩cil)
81
82```bash
83# 1. Ir a la carpeta
84cd backtesting_app_v2
85
86# 2. Levantar todo
87docker-compose up -d
88
89# 3. Ver logs
90docker-compose logs -f
91
92# Listo! Acceder a:
93# - API: http://localhost:8000
94# - Streamlit: http://localhost:8501
95```
96
97## Accesos
98
99| Servicio | URL | Descripci贸n |
100|----------|-----|-------------|
101| API | http://localhost:8000 | Backend FastAPI |
102| API Docs | http://localhost:8000/docs | Documentaci贸n interactiva |
103| Health | http://localhost:8000/health | Estado del servicio |
104| Streamlit | http://localhost:8501 | Interfaz de usuario |
105
106## Configuraci贸n R谩pida
107
108Edita `.env` para cambiar:
109```bash
110# M谩s logs en desarrollo
111DEBUG=True
112LOG_LEVEL=DEBUG
113
114# M谩s requests permitidos
115RATE_LIMIT_PER_MINUTE=300
116
117# Desactivar cache (testing)
118ENABLE_CACHE=False
119```
120
121## Troubleshooting
122
123**Error: "Module not found"**
124```bash
125pip install -r requirements.txt
126```
127
128**Error: "Port 8000 in use"**
129```bash
130# Cambiar en .env
131API_PORT=8001
132```
133
134**Docker no inicia**
135```bash
136docker-compose down
137docker-compose up -d --build
138```
139
140**Limpiar cache**
141```bash
142rm -rf cache/*
143# O desde API: POST /api/cache/clear
144```
145
146## Pr贸ximos Pasos
147
1481. Lee [README_V2.md](README_V2.md) para documentaci贸n completa
1492. Revisa [CHANGES_V2.md](CHANGES_V2.md) para ver todas las mejoras
1503. Configura `.env` seg煤n tus necesidades
1514. 隆Empieza a hacer backtests!
152
153## Soporte
154
155- Ver logs: `tail -f logs/app.log`
156- Verificar salud: `curl http://localhost:8000/health`
157- Cache stats: incluido en `/health`
158
159---
160
161**Versi贸n:** 2.0.0
162**脷ltima actualizaci贸n:** Enero 2026
163