Você já se perguntou como a elite de Wall Street usa IA para ganhar milhões? Com o projeto AI Hedge Fund, você pode mergulhar no mundo da negociação automatizada sem arriscar um centavo. Esta joia de código aberto do GitHub permite simular um fundo de hedge alimentado por agentes de IA inspirados em lendas como Warren Buffett e Cathie Wood. Fiquei fascinado explorando suas estratégias de negociação e, neste tutorial, mostrarei como configurar seu próprio AI Hedge Fund, executar uma simulação de negociação com ações como Apple e Microsoft, e dar uma olhada nos bastidores de seus agentes inteligentes. Não é necessário PhD em finanças—apenas curiosidade e um laptop! Pronto para brincar de gerente de fundo de hedge? Mãos à obra!
O que é o AI Hedge Fund? Sua Equipe de Negociação Virtual
O AI Hedge Fund é um projeto de código aberto no GitHub que simula um fundo de hedge usando agentes de IA para tomar decisões de negociação. Você pode pensar nisso como uma equipe dos sonhos digital, onde cada agente tem uma especialidade, imitando gurus de investimento do mundo real. Construído para fins educacionais, ele usa modelos de linguagem grandes (LLMs) como GPT-4o ou Llama 3 para analisar dados financeiros e simular negociações—nenhum dinheiro real envolvido. Principais recursos incluem:
- Agentes Especializados: Fundamentos, Análise Técnica, Sentimento, Gerente de Risco e Gerente de Portfólio analisam dados e tomam decisões.
- Fontes de Dados: Obtém dados financeiros gratuitos para ações como AAPL, MSFT, NVDA, GOOGL e TSLA via API Financial Datasets.
- Customizável: Execute-o com LLMs baseados na nuvem (OpenAI, Groq) ou modelos locais via Ollama.
- Simulação: Faz backtests de estratégias para ver como as negociações teriam se saído.
Com mais de 2 mil estrelas, é um sucesso para aprender como a IA está revolucionando os fundos de hedge. Vamos configurá-lo para negociar de forma mais inteligente que um 'bro' de Wall Street!

Configurando Seu Ambiente para o AI Hedge Fund
Antes de liberarmos seu AI Hedge Fund, vamos preparar seu sistema. Isso é amigável para iniciantes, e vou guiá-lo por cada passo.
1. Verifique os Requisitos do Sistema:
- Sistema Operacional: Windows (com WSL2), macOS ou Linux (Ubuntu 20.04+ recomendado).
- Software:
- Python 3.10 (verifique com
python3 --version
). - Git (verifique com
git --version
). - Docker CLI ou Docker Desktop para Ollama (opcional, para LLMs locais).
- Se você estiver no Windows, instale o WSL2 executando
wsl --install
no PowerShell (Admin) e reinicie. Está faltando alguma coisa? Instale agora em python.org ou git-scm.com.
2. Instale o Poetry: O Poetry gerencia dependências Python. Instale-o:
curl -sSL https://install.python-poetry.org | python3 -
Verifique com poetry --version
(por exemplo, 1.8.0). Adicione o Poetry ao seu PATH se necessário: export PATH="$HOME/.local/bin:$PATH"
.
3. Obtenha Chaves de API:
- OpenAI: Cadastre-se em platform.openai.com para acesso ao GPT-4o. Copie sua chave de API.
- Financial Datasets: Registre-se em financialdatasets.ai para dados de ações gratuitos (AAPL, MSFT, etc.). Copie a chave.
- Opcional: Chaves Groq (groq.com) ou Anthropic (anthropic) para outros LLMs, ou Ollama para modelos locais.
4. Crie uma Pasta de Projeto: Mantenha-se organizado:
mkdir ai-hedge-fund
cd ai-hedge-fund
Instalando o AI Hedge Fund
Agora, vamos clonar e configurar o projeto AI Hedge Fund. É rápido e o prepara para simulações de negociação.
1. Clone o Repositório: Obtenha o código do GitHub:
git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund
Isso baixa o projeto (~50MB), incluindo scripts de agentes e ferramentas.
2. Instale as Dependências: Use o Poetry para instalar as bibliotecas necessárias:
poetry install
Isso configura pacotes Python como pandas
, requests
e SDKs de LLM. Leva um ou dois minutos.
3. Configure as Chaves de API: Crie um arquivo .env
para armazenar suas chaves:
cp .env.example .env
Edite o .env
com um editor de texto (por exemplo, nano .env
) e adicione:
# Para executar LLMs hospedados pela openai (gpt-4o, gpt-4o-mini, etc.)
# Obtenha sua chave de API OpenAI em https://platform.openai.com/
OPENAI_API_KEY=sua-chave-de-api-openai
# Para executar LLMs hospedados pela groq (deepseek, llama3, etc.)
# Obtenha sua chave de API Groq em https://groq.com/
GROQ_API_KEY=sua-chave-de-api-groq
# Para obter dados financeiros para alimentar o fundo de hedge
# Obtenha sua chave de API Financial Datasets em https://financialdatasets.ai/
FINANCIAL_DATASETS_API_KEY=sua-chave-de-api-financial-datasets
Salve e saia. Para LLMs locais, pule o OpenAI e use o Ollama (veja abaixo).
4. Opcional: Configure o Ollama para LLMs Locais: Quer executar modelos como o Llama 3 localmente? Instale o Ollama:
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3
Inicie o Ollama: ollama serve
. Isso usa ~5GB para o Llama 3. Certifique-se de que o Docker esteja instalado (docker.com) se estiver executando via Docker.

Executando Seu AI Hedge Fund: Uma Simulação de Negociação
Vamos ligar seu AI Hedge Fund e simular negociações de ações como Apple (AAPL) e Microsoft (MSFT). Veremos como os agentes de IA trabalham juntos.
1. Execute a Simulação: Na pasta ai-hedge-fund
, execute:
poetry run python src/main.py --ticker AAPL,MSFT
Ou, para LLMs locais:
poetry run python src/main.py --ticker AAPL,MSFT --ollama
Este comando:
- Tem como alvo AAPL e MSFT (dados gratuitos do Financial Datasets).
- Usa agentes de IA para analisar fundamentos (por exemplo, relação P/L), análise técnica (por exemplo, médias móveis), sentimento (por exemplo, notícias) e riscos.
- Simula negociações e gera decisões.
2. O Que Acontece?: Os agentes colaboram:
- Agente de Fundamentos: Verifica o crescimento da receita da AAPL e o fluxo de caixa da MSFT.
- Agente de Análise Técnica: Analisa médias móveis de 50 dias para sinais de compra/venda.
- Agente de Sentimento: Examina notícias em busca de vibrações positivas/negativas (por exemplo, "Apple lança novo iPhone").
- Gerente de Risco: Define limites de posição para evitar grandes perdas.
- Gerente de Portfólio: Decide comprar 100 ações da AAPL e manter a MSFT com base nos sinais.

Veja os Resultados: Verifique o terminal para decisões de negociação, probabilidades e resultados de backtest. Logs são salvos em src/logs/
.
3. Executando o Backtester: use o seguinte comando:
poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA
Exemplo de Saída:

Você também tem a opção de especificar as datas de início e fim para fazer backtest em um período específico.
# Com Poetry:
poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01
# Com Docker (no Linux/Mac):
./run.sh --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 backtest
# Com Docker (no Windows):
run.bat --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 backtest
Explorando Recursos do AI Hedge Fund
Seu AI Hedge Fund é mais do que um script—é um playground de aprendizado. Veja como se aprofundar:
- Customização de Agentes: Edite scripts de agentes em
src/agents/
(por exemplo,bill_ackman.py
para investimento ativista). Ajuste estratégias como comprar ações subvalorizadas. - Adicionar Ações: Experimente NVDA ou TSLA na flag
--ticker
(requer uma chave de API do Financial Datasets para ações não gratuitas). - Backtesting: A ferramenta
backtester.py
simula desempenho histórico. Executepoetry run python src/backtester.py --ticker AAPL
para ver retornos passados. - Análise de Sentimento: O Agente de Sentimento usa PNL (Processamento de Linguagem Natural) para analisar notícias e mídias sociais, aumentando a precisão das decisões. Teste com: "Analyze NVDA news sentiment."
- Executar Localmente: Use o Ollama com
llama3
para simulações de negociação offline, economizando custos de API.
Eu ajustei o Agente de Análise Técnica para focar no RSI (Índice de Força Relativa) e vi sinais de compra mais nítidos—super divertido de experimentar!
Documentando Suas APIs com APIdog
Construindo sobre seu AI Hedge Fund e quer documentar suas APIs para outros? O APIdog é uma ferramenta de primeira linha para criar documentação de API interativa. Seu design elegante e opções de auto-hospedagem o tornam perfeito para compartilhar os endpoints do seu sistema de negociação—experimente!

Solução de Problemas e Dicas
- Erros de Chave de API: Certifique-se de que as chaves no
.env
correspondem às suas contas OpenAI/Financial Datasets. Verifique comcat .env
. - Problemas de Dependência: Se
poetry install
falhar, atualize o Poetry:poetry self update
. - Ollama Não Conectando: Verifique se
ollama serve
está rodando e a porta 11434 está aberta (netstat -tulpn | grep 11434
no Linux). - Desempenho: Para execuções mais rápidas, use uma GPU com Ollama ou mantenha-se com LLMs na nuvem como GPT-4o.
- Comunidade: Participe das Discussões do projeto no GitHub para obter ajuda ou compartilhar seus agentes customizados.
Por Que Usar um AI Hedge Fund?
Este projeto AI Hedge Fund é uma mina de ouro para aprendizado:
- Educacional: Entenda como a IA impulsiona a negociação em empresas como a Two Sigma.
- Sem Risco: Simule negociações sem perder dinheiro.
- Customizável: Ajuste agentes para combinar com seu estilo de investimento.
- De Ponta: Usa LLMs e PNL, espelhando a tecnologia real de fundos de hedge.
É como um laboratório de finanças onde você é o cientista maluco. Adorei ver o Agente de Sentimento capturar notícias otimistas sobre a MSFT e ajustar as negociações!
Considerações Finais: Torne-se um Profissional de Negociação com IA
Parabéns—você lançou seu próprio AI Hedge Fund e simulou negociações como um mago de Wall Street! Desde configurar agentes de IA até executar negociações na AAPL e MSFT, agora você faz parte da revolução do investimento com IA. Experimente com novas ações, ajuste agentes ou documente suas APIs com APIdog. Compartilhe seus ajustes no AI Hedge Fund no X ou GitHub—estou animado para ver seu império de negociação crescer! Boa simulação!