Thanks for wanting to contribute! This project is small and deliberately simple — keep it that way.
- Fork the repo
git clone git@github.com:<you>/hft-engine-python.gitpip install -r requirements.txt- Create a branch:
git checkout -b feat/your-feature
- New strategies (momentum, breakout, mean-reversion variants)
- New data sources (databento, polygon, kraken websocket)
- Bug fixes with a failing test case
- Documentation / README improvements
- Python 3.11+, type hints on public functions
- No new dependencies unless they earn their place
- Keep the event-driven architecture: market data → strategy → risk → order manager
There's no formal test suite yet — run the CLI on a known symbol/period and confirm the output matches the README sample results:
python main.py --symbol AAPL --start 2023-01-01 --end 2024-01-01 --strategy sma- Push your branch
- Open a PR against
main - Describe what you changed and why, with sample output if it affects behavior
Be kind. No harassment, no spam, no fake contributions.