Home

Welcome to Petunia

Petunia is a modular, Dockerized algorithmic trading engine acting as a "Shadow Automator" for retail trading. Unlike traditional bots that execute directly on exchanges, Petunia handles the entire quantitative pipeline—Data ETL, Strategy Execution, Risk Management, and Portfolio Accounting—while synchronizing trade instructions via a Google Sheet interface for manual broker execution.

🌟 Key Features

• Shadow Execution: Decouples logic from execution. The system runs the math; you control the button.
• Dockerized Architecture: The entire stack (Python App + PostgreSQL) runs in isolated containers, ensuring environment consistency.
• Strategy Factory: A modular engine supporting multiple technical strategies (Trend Following & Mean Reversion).
• Risk-First Design: Built-in Risk Manager enforcing the 2% Rule and ATR-based volatility stops.
• Full Testing Suite: Extensive Unit and Integration tests to ensure financial logic integrity.

📚 Documentation Structure

• Strategy Playbook: Deep dive into the mathematical models (EMA, RSI) used to generate signals.
• Risk Management Bible: How Petunia calculates position sizing and protects capital.
• Architecture & Data Flow: Technical overview of the system internals.
• Operational Guide: How to run daily routines, backtests, and troubleshooting.