# BackTesterAgent 🚀
[](https://discord.gg/agora-999382051935506503) [](https://www.youtube.com/@kyegomez3242) [](https://www.linkedin.com/in/kye-g-38759a207/) [](https://x.com/kyegomezb)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://github.com/kyegomez/swarms)
[](https://github.com/psf/black)
[](https://pepy.tech/project/backtesteragent)
An enterprise-grade AI-powered backtesting framework built on the Swarms framework for automated trading strategy validation and optimization.
## 🌟 Features
- **Advanced Technical Analysis**: Comprehensive suite of technical indicators (SMA, RSI, MACD)
- **Real-Time Data Integration**: Seamless integration with Yahoo Finance for live market data
- **AI-Powered Decision Making**: Leveraging GPT-4 through the Swarms framework
- **Robust Portfolio Management**: Sophisticated position tracking and trade execution
- **Enterprise-Grade Logging**: Detailed logging with Loguru for production environments
- **Type-Safe Implementation**: Comprehensive type hints and dataclass usage
- **Performance Analytics**: In-depth metrics including Sharpe ratio and maximum drawdown
- **Interactive Visualizations**: Real-time trading activity and portfolio performance charts
## 🛠️ Installation
```bash
pip3 install -U backtester-agent
```
## 📋 Requirements
- Python 3.8+
- backtester package: `pip3 install -U backtester-agent`
- API Key for OpenAI
## 🚀 Quick Start
```python
from backtester_agent.main import run_backtest
run_backtest(cash=500.0, symbol="AAPL", start_date="2024-11-16", end_date="2024-11-18", trade_size=10)
```
## 📊 Example Output
```plaintext
2024-01-18 10:30:15 | INFO | Starting backtest for AAPL
2024-01-18 10:30:16 | INFO | Processing 252 trading days
2024-01-18 10:30:45 | SUCCESS | Backtest completed
Backtest Results:
Initial Portfolio Value: $100,000.00
Final Portfolio Value: $125,432.10
Total Return: 25.43%
Sharpe Ratio: 1.85
Maximum Drawdown: -8.32%
Total Trades: 45
```
## 🔧 Configuration
Configure the agent through environment variables or a config file:
```env
OPENAI_API_KEY=your_api_key_here
WORKSPACE_DIR="agent_workspace"
SWARMS_API_KEY=your_swarms_api_key_here # Get from swarms.ai dashboard
```
## 🏗️ Architecture
```mermaid
graph TD
A[FinancialData] -->|Price Data| B[BackTester]
B -->|Market State| C[FinancialAgent]
C -->|Decisions| D[Portfolio]
D -->|Execution| B
E[Technical Indicators] -->|Analysis| C
```
## 📈 Performance Metrics
The BackTesterAgent provides comprehensive performance analytics:
- Total Return
- Sharpe Ratio
- Maximum Drawdown
- Trade Count
- Win/Loss Ratio
- Risk-Adjusted Return
## 🔍 Logging and Monitoring
Detailed logging is implemented using Loguru:
```python
logger.add(
"backtester_{time}.log",
rotation="500 MB",
retention="10 days",
level="INFO"
)
```
## 🔒 Security
- Environment variable management for sensitive data
- Secure API key handling
- Rate limiting for API calls
- Error handling and validation
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📜 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- [Swarms Framework](https://github.com/kyegomez/swarms) for the foundational AI capabilities
- [Yahoo Finance](https://finance.yahoo.com/) for market data
- All contributors and maintainers
## 📞 Support
- Documentation: [Link to Docs]
- Issues: [GitHub Issues](https://github.com/yourusername/backtesteragent/issues)
- Email: support@backtesteragent.com
- Discord: [Join our community](https://discord.gg/backtesteragent)
## 🗺️ Roadmap
- [ ] Advanced strategy optimization
- [ ] Multi-asset portfolio support
- [ ] Machine learning integration
- [ ] Real-time trading capabilities
- [ ] Enhanced risk management features
## 📊 Benchmarks
Performance benchmarks against standard trading strategies:
| Strategy | Return | Sharpe Ratio | Max Drawdown |
|----------|---------|--------------|--------------|
| Buy & Hold | 15.2% | 0.95 | -12.3% |
| BackTesterAgent | 25.4% | 1.85 | -8.3% |
| Market Index | 12.1% | 0.82 | -15.7% |
---
Built with ❤️ by [Swarms](https://swarms.ai)
Raw data
{
"_id": null,
"home_page": "https://github.com/The-Swarm-Corporation/BackTesterAgent",
"name": "backtester-agent",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "artificial intelligence, deep learning, optimizers, Prompt Engineering",
"author": "Kye Gomez",
"author_email": "kye@apac.ai",
"download_url": "https://files.pythonhosted.org/packages/9d/e7/e09ff88ff7472dddd1b17885616556fd6f867ec7ae0be9e512ba9e2160de/backtester_agent-0.0.2.tar.gz",
"platform": null,
"description": "\n\n# BackTesterAgent \ud83d\ude80\n\n[](https://discord.gg/agora-999382051935506503) [](https://www.youtube.com/@kyegomez3242) [](https://www.linkedin.com/in/kye-g-38759a207/) [](https://x.com/kyegomezb)\n\n\n[](https://opensource.org/licenses/MIT)\n[](https://www.python.org/downloads/)\n[](https://github.com/kyegomez/swarms)\n[](https://github.com/psf/black)\n[](https://pepy.tech/project/backtesteragent)\n\nAn enterprise-grade AI-powered backtesting framework built on the Swarms framework for automated trading strategy validation and optimization.\n\n## \ud83c\udf1f Features\n\n- **Advanced Technical Analysis**: Comprehensive suite of technical indicators (SMA, RSI, MACD)\n- **Real-Time Data Integration**: Seamless integration with Yahoo Finance for live market data\n- **AI-Powered Decision Making**: Leveraging GPT-4 through the Swarms framework\n- **Robust Portfolio Management**: Sophisticated position tracking and trade execution\n- **Enterprise-Grade Logging**: Detailed logging with Loguru for production environments\n- **Type-Safe Implementation**: Comprehensive type hints and dataclass usage\n- **Performance Analytics**: In-depth metrics including Sharpe ratio and maximum drawdown\n- **Interactive Visualizations**: Real-time trading activity and portfolio performance charts\n\n## \ud83d\udee0\ufe0f Installation\n\n```bash\npip3 install -U backtester-agent\n```\n\n## \ud83d\udccb Requirements\n\n- Python 3.8+\n- backtester package: `pip3 install -U backtester-agent`\n- API Key for OpenAI\n\n## \ud83d\ude80 Quick Start\n\n```python\nfrom backtester_agent.main import run_backtest\n\nrun_backtest(cash=500.0, symbol=\"AAPL\", start_date=\"2024-11-16\", end_date=\"2024-11-18\", trade_size=10)\n```\n\n## \ud83d\udcca Example Output\n\n```plaintext\n2024-01-18 10:30:15 | INFO | Starting backtest for AAPL\n2024-01-18 10:30:16 | INFO | Processing 252 trading days\n2024-01-18 10:30:45 | SUCCESS | Backtest completed\n\nBacktest Results:\nInitial Portfolio Value: $100,000.00\nFinal Portfolio Value: $125,432.10\nTotal Return: 25.43%\nSharpe Ratio: 1.85\nMaximum Drawdown: -8.32%\nTotal Trades: 45\n```\n\n## \ud83d\udd27 Configuration\n\nConfigure the agent through environment variables or a config file:\n\n```env\nOPENAI_API_KEY=your_api_key_here\nWORKSPACE_DIR=\"agent_workspace\"\nSWARMS_API_KEY=your_swarms_api_key_here # Get from swarms.ai dashboard\n```\n\n## \ud83c\udfd7\ufe0f Architecture\n\n```mermaid\ngraph TD\n A[FinancialData] -->|Price Data| B[BackTester]\n B -->|Market State| C[FinancialAgent]\n C -->|Decisions| D[Portfolio]\n D -->|Execution| B\n E[Technical Indicators] -->|Analysis| C\n```\n\n## \ud83d\udcc8 Performance Metrics\n\nThe BackTesterAgent provides comprehensive performance analytics:\n\n- Total Return\n- Sharpe Ratio\n- Maximum Drawdown\n- Trade Count\n- Win/Loss Ratio\n- Risk-Adjusted Return\n\n## \ud83d\udd0d Logging and Monitoring\n\nDetailed logging is implemented using Loguru:\n\n```python\nlogger.add(\n \"backtester_{time}.log\",\n rotation=\"500 MB\",\n retention=\"10 days\",\n level=\"INFO\"\n)\n```\n\n## \ud83d\udd12 Security\n\n- Environment variable management for sensitive data\n- Secure API key handling\n- Rate limiting for API calls\n- Error handling and validation\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## \ud83d\udcdc License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- [Swarms Framework](https://github.com/kyegomez/swarms) for the foundational AI capabilities\n- [Yahoo Finance](https://finance.yahoo.com/) for market data\n- All contributors and maintainers\n\n## \ud83d\udcde Support\n\n- Documentation: [Link to Docs]\n- Issues: [GitHub Issues](https://github.com/yourusername/backtesteragent/issues)\n- Email: support@backtesteragent.com\n- Discord: [Join our community](https://discord.gg/backtesteragent)\n\n## \ud83d\uddfa\ufe0f Roadmap\n\n- [ ] Advanced strategy optimization\n- [ ] Multi-asset portfolio support\n- [ ] Machine learning integration\n- [ ] Real-time trading capabilities\n- [ ] Enhanced risk management features\n\n## \ud83d\udcca Benchmarks\n\nPerformance benchmarks against standard trading strategies:\n\n| Strategy | Return | Sharpe Ratio | Max Drawdown |\n|----------|---------|--------------|--------------|\n| Buy & Hold | 15.2% | 0.95 | -12.3% |\n| BackTesterAgent | 25.4% | 1.85 | -8.3% |\n| Market Index | 12.1% | 0.82 | -15.7% |\n\n---\n\nBuilt with \u2764\ufe0f by [Swarms](https://swarms.ai)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Backtester Agent",
"version": "0.0.2",
"project_urls": {
"Documentation": "https://github.com/The-Swarm-Corporation/BackTesterAgent",
"Homepage": "https://github.com/The-Swarm-Corporation/BackTesterAgent",
"Repository": "https://github.com/The-Swarm-Corporation/BackTesterAgent"
},
"split_keywords": [
"artificial intelligence",
" deep learning",
" optimizers",
" prompt engineering"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "57b10f0b11e6f7ac788e20946aed1f8858ebb8be09d2a3663c1f0855c81826e5",
"md5": "21b10ca2d066c2c05d4abc3df08bf894",
"sha256": "2100c6dbfa1541f67b8a8f4f839e7d9d146ae9e55b354fea49a6649041f487e6"
},
"downloads": -1,
"filename": "backtester_agent-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "21b10ca2d066c2c05d4abc3df08bf894",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 9179,
"upload_time": "2024-11-19T00:16:30",
"upload_time_iso_8601": "2024-11-19T00:16:30.322212Z",
"url": "https://files.pythonhosted.org/packages/57/b1/0f0b11e6f7ac788e20946aed1f8858ebb8be09d2a3663c1f0855c81826e5/backtester_agent-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9de7e09ff88ff7472dddd1b17885616556fd6f867ec7ae0be9e512ba9e2160de",
"md5": "e42886f505ab4e8e13cf02d59a93b4e1",
"sha256": "a58f534c71489ec880372286e2a4249b84dd862fa266ca73e62fd4946a714f69"
},
"downloads": -1,
"filename": "backtester_agent-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "e42886f505ab4e8e13cf02d59a93b4e1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 8645,
"upload_time": "2024-11-19T00:16:32",
"upload_time_iso_8601": "2024-11-19T00:16:32.061957Z",
"url": "https://files.pythonhosted.org/packages/9d/e7/e09ff88ff7472dddd1b17885616556fd6f867ec7ae0be9e512ba9e2160de/backtester_agent-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-19 00:16:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "The-Swarm-Corporation",
"github_project": "BackTesterAgent",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "backtester-agent"
}
JSON
