{"id":22336338,"url":"https://github.com/virattt/ai-hedge-fund","last_synced_at":"2026-02-06T04:13:48.137Z","repository":{"id":265505273,"uuid":"896144595","full_name":"virattt/ai-hedge-fund","owner":"virattt","description":"An AI Hedge Fund Team","archived":false,"fork":false,"pushed_at":"2026-02-02T20:45:33.000Z","size":3024,"stargazers_count":45579,"open_issues_count":51,"forks_count":7990,"subscribers_count":566,"default_branch":"main","last_synced_at":"2026-02-03T10:43:46.047Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/virattt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-29T16:30:01.000Z","updated_at":"2026-02-03T10:39:42.000Z","dependencies_parsed_at":"2024-12-31T18:17:46.209Z","dependency_job_id":"403a98ab-8f33-4c02-aa00-ba2a7c0c0f4f","html_url":"https://github.com/virattt/ai-hedge-fund","commit_stats":null,"previous_names":["virattt/ai-hedge-fund"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/virattt/ai-hedge-fund","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/virattt%2Fai-hedge-fund","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/virattt%2Fai-hedge-fund/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/virattt%2Fai-hedge-fund/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/virattt%2Fai-hedge-fund/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/virattt","download_url":"https://codeload.github.com/virattt/ai-hedge-fund/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/virattt%2Fai-hedge-fund/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29150016,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T02:39:25.012Z","status":"ssl_error","status_checked_at":"2026-02-06T02:37:22.784Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-04T06:02:37.197Z","updated_at":"2026-02-06T04:13:48.132Z","avatar_url":"https://github.com/virattt.png","language":"Python","funding_links":[],"categories":["Python","Quant","🤖 AI \u0026 Machine Learning","AI Agents for Finance","Finance-Specific AI","⚙️ AI Agent Frameworks \u0026 Multi-Agent Platforms","LLMs","AI \u0026 Machine Learning","Recently Updated","Table of Contents","🔥 AI Powered Systematic Trading Systems","11. Specialized Domains","Repos","💰 Finance \u0026 Fintech","AI \u0026 LLM Agents","超越加密货币：AI 交易","Agents","Candidates to Review","💰 ფინანსური AI","Machine Learning"],"sub_categories":["Spatial, Satellite and Alternative Data","Books","[Apr 13, 2025](/content/2025/04/13/README.md)","🟩 Development Tools 🛠️","洞见与讨论","Single-agent end-to-end traders","Cryptocurrencies"],"readme":"# AI Hedge Fund\n\nThis is a proof of concept for an AI-powered hedge fund.  The goal of this project is to explore the use of AI to make trading decisions.  This project is for **educational** purposes only and is not intended for real trading or investment.\n\nThis system employs several agents working together:\n\n1. Aswath Damodaran Agent - The Dean of Valuation, focuses on story, numbers, and disciplined valuation\n2. Ben Graham Agent - The godfather of value investing, only buys hidden gems with a margin of safety\n3. Bill Ackman Agent - An activist investor, takes bold positions and pushes for change\n4. Cathie Wood Agent - The queen of growth investing, believes in the power of innovation and disruption\n5. Charlie Munger Agent - Warren Buffett's partner, only buys wonderful businesses at fair prices\n6. Michael Burry Agent - The Big Short contrarian who hunts for deep value\n7. Mohnish Pabrai Agent - The Dhandho investor, who looks for doubles at low risk\n8. Peter Lynch Agent - Practical investor who seeks \"ten-baggers\" in everyday businesses\n9. Phil Fisher Agent - Meticulous growth investor who uses deep \"scuttlebutt\" research \n10. Rakesh Jhunjhunwala Agent - The Big Bull of India\n11. Stanley Druckenmiller Agent - Macro legend who hunts for asymmetric opportunities with growth potential\n12. Warren Buffett Agent - The oracle of Omaha, seeks wonderful companies at a fair price\n13. Valuation Agent - Calculates the intrinsic value of a stock and generates trading signals\n14. Sentiment Agent - Analyzes market sentiment and generates trading signals\n15. Fundamentals Agent - Analyzes fundamental data and generates trading signals\n16. Technicals Agent - Analyzes technical indicators and generates trading signals\n17. Risk Manager - Calculates risk metrics and sets position limits\n18. Portfolio Manager - Makes final trading decisions and generates orders\n\n\u003cimg width=\"1042\" alt=\"Screenshot 2025-03-22 at 6 19 07 PM\" src=\"https://github.com/user-attachments/assets/cbae3dcf-b571-490d-b0ad-3f0f035ac0d4\" /\u003e\n\nNote: the system does not actually make any trades.\n\n[![Twitter Follow](https://img.shields.io/twitter/follow/virattt?style=social)](https://twitter.com/virattt)\n\n## Disclaimer\n\nThis project is for **educational and research purposes only**.\n\n- Not intended for real trading or investment\n- No investment advice or guarantees provided\n- Creator assumes no liability for financial losses\n- Consult a financial advisor for investment decisions\n- Past performance does not indicate future results\n\nBy using this software, you agree to use it solely for learning purposes.\n\n## Table of Contents\n- [How to Install](#how-to-install)\n- [How to Run](#how-to-run)\n  - [⌨️ Command Line Interface](#️-command-line-interface)\n  - [🖥️ Web Application](#️-web-application)\n- [How to Contribute](#how-to-contribute)\n- [Feature Requests](#feature-requests)\n- [License](#license)\n\n## How to Install\n\nBefore you can run the AI Hedge Fund, you'll need to install it and set up your API keys. These steps are common to both the full-stack web application and command line interface.\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/virattt/ai-hedge-fund.git\ncd ai-hedge-fund\n```\n\n### 2. Set up API keys\n\nCreate a `.env` file for your API keys:\n```bash\n# Create .env file for your API keys (in the root directory)\ncp .env.example .env\n```\n\nOpen and edit the `.env` file to add your API keys:\n```bash\n# For running LLMs hosted by openai (gpt-4o, gpt-4o-mini, etc.)\nOPENAI_API_KEY=your-openai-api-key\n\n# For getting financial data to power the hedge fund\nFINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key\n```\n\n**Important**: You must set at least one LLM API key (e.g. `OPENAI_API_KEY`, `GROQ_API_KEY`, `ANTHROPIC_API_KEY`, or `DEEPSEEK_API_KEY`) for the hedge fund to work. \n\n**Financial Data**: Data for AAPL, GOOGL, MSFT, NVDA, and TSLA is free and does not require an API key. For any other ticker, you will need to set the `FINANCIAL_DATASETS_API_KEY` in the .env file.\n\n## How to Run\n\n### ⌨️ Command Line Interface\n\nYou can run the AI Hedge Fund directly via terminal. This approach offers more granular control and is useful for automation, scripting, and integration purposes.\n\n\u003cimg width=\"992\" alt=\"Screenshot 2025-01-06 at 5 50 17 PM\" src=\"https://github.com/user-attachments/assets/e8ca04bf-9989-4a7d-a8b4-34e04666663b\" /\u003e\n\n#### Quick Start\n\n1. Install Poetry (if not already installed):\n```bash\ncurl -sSL https://install.python-poetry.org | python3 -\n```\n\n2. Install dependencies:\n```bash\npoetry install\n```\n\n#### Run the AI Hedge Fund\n```bash\npoetry run python src/main.py --ticker AAPL,MSFT,NVDA\n```\n\nYou can also specify a `--ollama` flag to run the AI hedge fund using local LLMs.\n\n```bash\npoetry run python src/main.py --ticker AAPL,MSFT,NVDA --ollama\n```\n\nYou can optionally specify the start and end dates to make decisions over a specific time period.\n\n```bash\npoetry run python src/main.py --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01\n```\n\n#### Run the Backtester\n```bash\npoetry run python src/backtester.py --ticker AAPL,MSFT,NVDA\n```\n\n**Example Output:**\n\u003cimg width=\"941\" alt=\"Screenshot 2025-01-06 at 5 47 52 PM\" src=\"https://github.com/user-attachments/assets/00e794ea-8628-44e6-9a84-8f8a31ad3b47\" /\u003e\n\n\nNote: The `--ollama`, `--start-date`, and `--end-date` flags work for the backtester, as well!\n\n### 🖥️ Web Application\n\nThe new way to run the AI Hedge Fund is through our web application that provides a user-friendly interface. This is recommended for users who prefer visual interfaces over command line tools.\n\nPlease see detailed instructions on how to install and run the web application [here](https://github.com/virattt/ai-hedge-fund/tree/main/app).\n\n\u003cimg width=\"1721\" alt=\"Screenshot 2025-06-28 at 6 41 03 PM\" src=\"https://github.com/user-attachments/assets/b95ab696-c9f4-416c-9ad1-51feb1f5374b\" /\u003e\n\n\n## How to Contribute\n\n1. Fork the repository\n2. Create a feature branch\n3. Commit your changes\n4. Push to the branch\n5. Create a Pull Request\n\n**Important**: Please keep your pull requests small and focused.  This will make it easier to review and merge.\n\n## Feature Requests\n\nIf you have a feature request, please open an [issue](https://github.com/virattt/ai-hedge-fund/issues) and make sure it is tagged with `enhancement`.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvirattt%2Fai-hedge-fund","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvirattt%2Fai-hedge-fund","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvirattt%2Fai-hedge-fund/lists"}