# Clone repository
git clone https://github.com/yourusername/catalyst-detector.git
cd catalyst-detector

# One-command setup (creates venv, installs deps, sets up DB)
make init

# Edit configuration with your API keys
nano .env

# Start monitoring
make daemon

# View logs
make logs

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install TA-Lib
brew install ta-lib  # macOS
# OR: sudo apt-get install libta-lib-dev  # Ubuntu
# OR: See TA-Lib Windows installation guide

# Install dependencies
pip install -r requirements.txt

# Setup database
python migrations/add_catalyst_outcomes.py

# Configure environment
cp .env.example .env
# Edit .env with your API keys

# Build and run with Docker Compose
docker-compose up -d

# View logs
docker-compose logs -f

# Stop
docker-compose down

# Copy example configuration
cp .env.example .env

# Edit with your API keys
nano .env

# Telegram (for alerts)
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id

# SEC EDGAR
EDGAR_USER_AGENT=your_email@example.com

# LLM (choose at least one)
GROQ_API_KEY=your_groq_key          # FREE, fast
GEMINI_API_KEY=your_gemini_key      # FREE, multimodal
OLLAMA_BASE_URL=http://localhost:11434  # LOCAL, private

# All FREE tier APIs
ALPHA_VANTAGE_KEY=your_key    # 25 calls/day
FMP_API_KEY=your_key          # 250 calls/day
MARKETAUX_API_KEY=your_key    # 100 calls/day

# Development workflow
make run          # Run single scan
make daemon       # Start background daemon
make stop         # Stop daemon
make logs         # Tail daemon logs

# Code quality
make format       # Format with black & isort
make lint         # Run linters (flake8, pylint, mypy)
make test         # Run tests with coverage
make security     # Security audit with bandit

# Utilities
make clean        # Clean cache and build artifacts
make update       # Update all dependencies

# Start daemon
source venv/bin/activate
python src/daemon.py

# Run single scan
python src/main.py

# Test Telegram connection
python -c "from utils.notifications import telegram_notifier; telegram_notifier.send_test_message()"

# Run migrations
python migrations/add_catalyst_outcomes.py

# Start service
docker-compose up -d

# View logs
docker-compose logs -f catalyst-detector

# Restart after config changes
docker-compose restart

# Stop service
docker-compose down

# Rebuild after code changes
docker-compose up -d --build

# Install development dependencies
make install-dev

# Setup pre-commit hooks (auto-format on commit)
pre-commit install

# Create feature branch
git checkout -b feature/amazing-feature

# Make changes, then test
make format        # Format code
make lint          # Check code quality
make test          # Run tests (>80% coverage required)
make security      # Security audit

# Commit and push
git add .
git commit -m "feat: add amazing feature"
git push origin feature/amazing-feature

# Run all tests with coverage
pytest tests/ -v --cov=src --cov-report=html

# Run specific test file
pytest tests/test_catalyst_detection.py -v

# Run with coverage report
make test
# Open htmlcov/index.html to view coverage