Initial v1 autonomous alpaca llm trading bot with dark dashboard

README.md

@@ -0,0 +1,33 @@
+# alpaca-llm-bot-v1
+
+Autonomous 2-hour trading loop powered by:
+- Alpaca trading API
+- Ollama local model inference
+- Searx web data ingestion
+- FastAPI dark dashboard
+
+## Safety defaults
+- `PAPER_MODE=true`
+- max order notional `$5`
+- confidence gate `>= 0.55` before order placement
+
+## Quick start
+```bash
+cp .env.example .env
+# fill ALPACA_API_KEY / ALPACA_API_SECRET
+chmod +x run.sh
+./run.sh
+```
+
+Open dashboard:
+- `http://<host>:8089/`
+
+Trigger immediate cycle:
+```bash
+curl -X POST http://127.0.0.1:8089/run-now
+```
+
+## Production notes
+- Put behind reverse proxy + auth
+- Keep paper mode until behavior validated
+- Add hard stop-loss and max daily drawdown before enabling live mode