Skip to content

Commit b798a69

Browse files
lalalunelalalune
committed
add ptbr readme
2 parents 2b05212 + 48c6758 commit b798a69

File tree

1 file changed

+69
-127
lines changed

1 file changed

+69
-127
lines changed

‎i18n/readme/README_PTBR.md

+69-127
Original file line numberDiff line numberDiff line change
@@ -2,181 +2,123 @@
22

33
<img src="/docs/static/img/eliza_banner.jpg" alt="Eliza Banner" width="100%" />
44

5-
## Funcionalidades
5+
## ✨ Features
66

7-
- 🛠 Conectores completos para Discord, Twitter e Telegram
8-
- 👥 Suporte a múltiplos agentes e salas
9-
- 📚 Ingestão e interação fácil com seus documentos
7+
- 🛠️ Conexão completa para Discord, Twitter e Telegram
8+
- 🔗 Suporte para todos os modelos (Llama, Grok, OpenAI, Anthropic, etc.)
9+
- 👥 Suporte para multi-agente e salas
10+
- 📚 Fácil interação com seus documentos
1011
- 💾 Memória recuperável e armazenamento de documentos
11-
- 🚀 Altamente extensível - crie suas próprias ações e clientes para estender as capacidades
12-
- ☁️ Suporta muitos modelos, incluindo Llama local, OpenAI, Anthropic, Groq e mais
13-
- 📦 Funciona perfeitamente!
12+
- 🚀 Altamente extensível - crie suas próprias ações e clientes
13+
- 📦 Simplesmente funciona!
1414

15-
## Para que posso usá-lo?
15+
## Tutoriais
16+
17+
[Escola Dev para Agentes IA (conteúdo em inglês)](https://www.youtube.com/watch?v=ArptLpQiKfI&list=PLx5pnFXdPTRzWla0RaOxALTSTnVq53fKL)
18+
19+
## 🎯 Em que posso usar?
1620

1721
- 🤖 Chatbots
1822
- 🕵️ Agentes autônomos
1923
- 📈 Gestão de processos empresariais
20-
- 🎮 NPCs em jogos de vídeo
24+
- 🎮 NPCs para o seus jogos
25+
- 🧠 Trading
2126

22-
# Começando
27+
## 🚀 Começando
2328

24-
**Pré-requisitos (OBRIGATÓRIO):**
29+
### Pré-requisitos
2530

2631
- [Python 2.7+](https://www.python.org/downloads/)
27-
- [Node.js 23.3+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
32+
- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
2833
- [pnpm](https://pnpm.io/installation)
2934

30-
### Edite o arquivo .env
31-
32-
- Copie .env.example para .env e preencha os valores apropriados
33-
- Edite as variáveis de ambiente do TWITTER para adicionar o nome de usuário e senha do seu bot
35+
> **Nota para usuários de Windows:** [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) é obrigatório.
3436
35-
### Edite o arquivo de personagem
37+
### Utilizando o Starter (Recomendado)
3638

37-
- Confira o arquivo `packages/core/src/defaultCharacter.ts` - você pode modificá-lo
38-
- Você também pode carregar personagens com o comando `pnpm start --characters="path/to/your/character.json"` e executar múltiplos bots ao mesmo tempo.
39+
```bash
40+
git clone https://github.com/ai16z/eliza-starter.git
3941

40-
Após configurar o arquivo .env e o arquivo de personagem, você pode iniciar o bot com o seguinte comando:
42+
cp .env.example .env
4143

44+
pnpm i && pnpm build && pnpm start
4245
```
43-
pnpm i
44-
pnpm start
45-
```
46-
47-
# Personalizando Eliza
48-
49-
### Adicionando ações personalizadas
50-
51-
Para evitar conflitos no diretório core, recomendamos adicionar ações personalizadas a um diretório `custom_actions` e depois adicioná-las ao arquivo `elizaConfig.yaml`. Veja o arquivo `elizaConfig.example.yaml` para um exemplo.
5246

53-
## Executando com diferentes modelos
47+
Leia a [Documentação](https://ai16z.github.io/eliza/) para aprender como customizar a sua Eliza.
5448

55-
### Executar com Llama
49+
### Executando Eliza manualmente (Recomendado apenas se você souber o que está fazendo)
5650

57-
Você pode executar modelos Llama 70B ou 405B configurando a variável de ambiente `XAI_MODEL` para `meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo` ou `meta-llama/Meta-Llama-3.1-405B-Instruct`
58-
59-
### Executar com Grok
51+
```bash
52+
# Clone o repositório
53+
git clone https://github.com/ai16z/eliza.git
6054

61-
Você pode executar modelos Grok configurando a variável de ambiente `XAI_MODEL` para `grok-beta`
55+
# Dê checkout no último release
56+
# O projeto está em constante e rápido desenvolvimento, então recomendamos que você cheque o último release
57+
git checkout $(git describe --tags --abbrev=0)
58+
```
6259

63-
### Executar com OpenAI
60+
### Execute Eliza com Gitpod
6461

65-
Você pode executar modelos OpenAI configurando a variável de ambiente `XAI_MODEL` para `gpt-4o-mini` ou `gpt-4o`
62+
[![Abrindo no Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/ai16z/eliza/tree/main)
6663

67-
## Requisitos Adicionais
64+
### Edite o arquivo .env
6865

69-
Pode ser necessário instalar o Sharp. Se você encontrar um erro ao iniciar, tente instalá-lo com o seguinte comando:
66+
Copie .env.example para .env e preencha os valores apropriados.
7067

7168
```
72-
pnpm install --include=optional sharp
69+
cp .env.example .env
7370
```
7471

75-
# Configuração do Ambiente
76-
77-
Você precisará adicionar variáveis de ambiente ao seu arquivo .env para se conectar a várias plataformas:
78-
79-
```
80-
# Variáveis de ambiente obrigatórias
81-
DISCORD_APPLICATION_ID=
82-
DISCORD_API_TOKEN= # Token do bot
83-
OPENAI_API_KEY=sk-* # Chave API do OpenAI, começando com sk-
84-
ELEVENLABS_XI_API_KEY= # Chave API do elevenlabs
85-
GOOGLE_GENERATIVE_AI_API_KEY= # Chave API do Gemini
86-
87-
# CONFIGURAÇÕES DO ELEVENLABS
88-
ELEVENLABS_MODEL_ID=eleven_multilingual_v2
89-
ELEVENLABS_VOICE_ID=21m00Tcm4TlvDq8ikWAM
90-
ELEVENLABS_VOICE_STABILITY=0.5
91-
ELEVENLABS_VOICE_SIMILARITY_BOOST=0.9
92-
ELEVENLABS_VOICE_STYLE=0.66
93-
ELEVENLABS_VOICE_USE_SPEAKER_BOOST=false
94-
ELEVENLABS_OPTIMIZE_STREAMING_LATENCY=4
95-
ELEVENLABS_OUTPUT_FORMAT=pcm_16000
96-
97-
TWITTER_DRY_RUN=false
98-
TWITTER_USERNAME= # Nome de usuário da conta
99-
TWITTER_PASSWORD= # Senha da conta
100-
TWITTER_EMAIL= # Email da conta
101-
102-
XAI_API_KEY=
103-
XAI_MODEL=
72+
Nota: .env é opcional. Se você estiver planejando rodar múltiplos agentes distintos, você pode passar segredos pelo JSON do personagem
10473

74+
### Execute Eliza automaticamente
10575

106-
# Para perguntar coisas ao Claude
107-
ANTHROPIC_API_KEY=
76+
Isso vai executar tudo que é necessário para configurar o projeto e começar o bot com o personagem padrão.
10877

109-
# EVM
110-
EVM_PRIVATE_KEY=EXAMPLE_WALLET_PRIVATE_KEY
111-
112-
# Solana
113-
SOLANA_PRIVATE_KEY=EXAMPLE_WALLET_PRIVATE_KEY
114-
SOLANA_PUBLIC_KEY=EXAMPLE_WALLET_PUBLIC_KEY
78+
```bash
79+
sh scripts/start.sh
80+
```
11581

116-
# Fallback Wallet Configuration (deprecated)
117-
WALLET_PRIVATE_KEY=EXAMPLE_WALLET_PRIVATE_KEY
118-
WALLET_PUBLIC_KEY=EXAMPLE_WALLET_PUBLIC_KEY
82+
### Edite o arquivo do personagem
11983

120-
BIRDEYE_API_KEY=
84+
1. Abra `packages/core/src/defaultCharacter.ts` para modificar o personagem padrão. Descomente e edite.
12185

122-
SOL_ADDRESS=So11111111111111111111111111111111111111112
123-
SLIPPAGE=1
124-
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
125-
HELIUS_API_KEY=
86+
2. Para carregar personsagens customizáveis:
87+
- Use `pnpm start --characters="path/to/your/character.json"`
88+
- Múltiplos arquivos de personagem podem ser usados de forma simultânea
89+
3. Conectando com o X (Twitter)
90+
- mude `"clients": []` para `"clients": ["twitter"]` no arquivo do personagem para conectar com o X
12691

92+
### Executando Eliza manualmente
12793

128-
## Telegram
129-
TELEGRAM_BOT_TOKEN=
94+
```bash
95+
pnpm i
96+
pnpm build
97+
pnpm start
13098

131-
TOGETHER_API_KEY=
99+
# O projeto está iterando bem rápido. Se você estiver voltando depois de um tempo, talvez precise fazer uma limpeza
100+
pnpm clean
132101
```
133102

134-
# Configuração de Inferência Local
103+
#### Requerimentos adicionais
135104

136-
### Configuração CUDA
137-
138-
Se você tiver uma GPU NVIDIA, pode instalar o CUDA para acelerar dramaticamente a inferência local.
105+
Talvez você precise instalar o Sharp. Se na hora de começar estiver apresentando algum erro, tente instalar com o seguinte comando:
139106

140107
```
141-
pnpm install
142-
npx --no node-llama-cpp source download --gpu cuda
108+
pnpm install --include=optional sharp
143109
```
144110

145-
Certifique-se de ter instalado o CUDA Toolkit, incluindo cuDNN e cuBLAS.
146-
147-
### Executando localmente
148-
149-
Adicione XAI_MODEL e configure-o para uma das opções acima de [Executar com Llama](#executar-com-llama) - você pode deixar XAI_API_KEY em branco, ele baixa o modelo do huggingface e faz consultas localmente
150-
151-
# Clientes
111+
### Comunidade & contato
152112

153-
## Bot do Discord
113+
- [GitHub Issues](https://github.com/ai16z/eliza/issues). Melhor utilizado para: bugs que você encontrar utilizando a Eliza, e propostas de features.
114+
- [Discord](https://discord.gg/ai16z). Melhor para: compartilhar seus apps e se conectar com a comunidade.
154115

155-
Para ajuda com a configuração do seu Bot do Discord, confira aqui: https://discordjs.guide/preparations/setting-up-a-bot-application.html
156-
157-
# Desenvolvimento
158-
159-
## Testes
160-
161-
Para executar a suíte de testes:
162-
163-
```bash
164-
pnpm test # Executar testes uma vez
165-
pnpm test:watch # Executar testes no modo watch
166-
```
167-
168-
Para testes específicos de banco de dados:
169-
170-
```bash
171-
pnpm test:sqlite # Executar testes com SQLite
172-
pnpm test:sqljs # Executar testes com SQL.js
173-
```
116+
## Contribuidores
174117

175-
Os testes são escritos usando Jest e podem ser encontrados em arquivos `src/**/*.test.ts`. O ambiente de teste está configurado para:
118+
<a href="https://github.com/ai16z/eliza/graphs/contributors">
119+
<img src="https://contrib.rocks/image?repo=ai16z/eliza" />
120+
</a>
176121

177-
- Carregar variáveis de ambiente de `.env.test`
178-
- Usar um tempo limite de 2 minutos para testes de longa duração
179-
- Suportar módulos ESM
180-
- Executar testes em sequência (--runInBand)
122+
## Histórico de estrelas
181123

182-
Para criar novos testes, adicione um arquivo `.test.ts` adjacente ao código que você está testando.
124+
[![Gráfico do histórico de estrelas](https://api.star-history.com/svg?repos=ai16z/eliza&type=Date)](https://star-history.com/#ai16z/eliza&Date)

0 commit comments

Comments
 (0)