https://github.com/kaueaclima/nlwagents
Project developed during Next Level Week (NLW) focused on AI and Game Integration. NLW Agents uses the GEMINI API to smartly answer questions about builds, strategies and tactics of League of Legends (LOL), Valorant and CS: GO.
https://github.com/kaueaclima/nlwagents
ai reactjs showdown typescript
Last synced: 3 months ago
JSON representation
Project developed during Next Level Week (NLW) focused on AI and Game Integration. NLW Agents uses the GEMINI API to smartly answer questions about builds, strategies and tactics of League of Legends (LOL), Valorant and CS: GO.
- Host: GitHub
- URL: https://github.com/kaueaclima/nlwagents
- Owner: KaueACLima
- Created: 2025-07-10T20:38:00.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-08-24T06:44:11.000Z (11 months ago)
- Last Synced: 2025-08-24T13:48:37.464Z (10 months ago)
- Topics: ai, reactjs, showdown, typescript
- Language: TypeScript
- Homepage:
- Size: 338 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧠 NLW Agents – Assistente de IA para Games Competitivos
Desenvolvido durante a **Next Level Week (NLW)** promovida pela Rocketseat, o **NLW Agents** é um assistente virtual inteligente que oferece dicas, estratégias e builds atualizadas para jogos competitivos como **League of Legends**, **Valorant** e **CS:GO**. Ele utiliza a poderosa API **Gemini** da Google para fornecer respostas rápidas, personalizadas e dentro do meta atual dos jogos.
---
## 🌟 Visão Geral
Com a popularização dos jogos online, ter um assistente confiável e inteligente pode ser o diferencial para melhorar seu desempenho. O **NLW Agents** foi criado para ajudar jogadores a tomar decisões estratégicas em tempo real, otimizando o desempenho e garantindo que estejam sempre atualizados com as melhores práticas no jogo.
---
### O que o NLW Agents oferece:
- **Respostas rápidas e inteligentes** baseadas em IA generativa.
- **Integração com o meta atual dos jogos**, sempre com conteúdo atualizado.
- **Suporte para múltiplos jogos**: League of Legends, Valorant e CS:GO.
- **Interface intuitiva e leve**, com suporte a Markdown (via Showdown.js).
- **API Key segura** através do Google Cloud, para integração com a API Gemini.
---
## ✨ Funcionalidades
### 🎮 Suporte aos jogos:
O assistente oferece suporte para os jogos mais populares e competitivos:
- **League of Legends**
- **Valorant**
- **CS:GO**
### 🔐 Segurança:
- Requisições realizadas com a **API Key segura** da Google Cloud, garantindo uma integração confiável.
### ⚡ Respostas rápidas e dinâmicas:
- A IA gera respostas personalizadas e rápidas com base no contexto do jogo e do meta atual.
### 📄 Markdown:
- A interface suporta **Markdown**, permitindo exibição de texto formatado, links, imagens e mais, proporcionando uma experiência rica e interativa.
### 📸 Screenshot:
(Adicione uma captura de tela ou GIF aqui para mostrar a interface em ação!)
---
## 🚀 Tecnologias Utilizadas
O **NLW Agents** foi desenvolvido com as seguintes tecnologias:
- **React**: Framework JavaScript para a construção da interface interativa.
- **TypeScript**: Adoção de tipagem estática para maior confiabilidade e escalabilidade do código.
- **HTML5 & CSS3**: Base para a estrutura e estilo da aplicação.
- **Showdown.js**: Biblioteca para renderizar conteúdo Markdown na interface.
- **Google Cloud (Gemini API)**: API da Google para IA generativa, utilizada para fornecer dicas e estratégias inteligentes.
---
## 🔐 Como Obter a API Key da Gemini
Para usar a API Gemini e integrar a IA generativa ao projeto, siga os passos abaixo para obter a sua **API Key**:
1. Acesse o **Google AI Studio**.
2. Faça login com sua conta **Google**.
3. Crie um novo projeto ou selecione um existente.
4. Vá até **APIs e Serviços** → **Biblioteca** e ative a **Generative Language API**.
5. Em **Credenciais**, clique em **Criar credenciais** e selecione **Chave de API**.
6. Copie a chave gerada e cole-a no campo correspondente na aplicação.
> ⚠️ **Importante**:
> - Não compartilhe sua chave publicamente!
> - Verifique os limites e custos associados ao uso da API.
> - Consulte a [documentação oficial da Gemini](https://cloud.google.com/gen-ai) para detalhes adicionais.
---
## 🧪 Como Usar
1. Clone o repositório e rode a aplicação localmente com os seguintes comandos:
```bash
git clone https://github.com/kaueaclima/nlwAgents.git
cd nlwAgents
npm install
npm start
```
2. A aplicação será aberta no seu navegador e você já poderá interagir com o assistente de IA!
---
## 🎥 Demonstração
Aqui está uma breve demonstração de como a aplicação funciona:
- O assistente faz sugestões de builds para **League of Legends**, ajustadas ao meta atual.
- Ele responde a perguntas específicas sobre **Valorant**, ajudando a melhorar a performance de jogo.
- O assistente oferece estratégias para **CS:GO**, levando em conta o comportamento do time adversário.
> (Inserir vídeo ou GIF de demonstração aqui)
---
## 📑 Contribuindo
Contribuições são bem-vindas! Para contribuir, siga os seguintes passos:
1. Fork o repositório.
2. Crie uma branch para suas alterações:
```bash
git checkout -b feature/nome-da-feature
```
3. Faça suas alterações e commit com uma mensagem clara:
```bash
git commit -m "Adiciona [feature]"
```
4. Envie para o repositório remoto:
```bash
git push origin feature/nome-da-feature
```
5. Abra uma **pull request** com uma descrição detalhada da modificação.
---
## 📝 Licença
Este projeto está licenciado sob a **MIT License**.
---
## 💬 Feedback e Suporte
Se você encontrar problemas ou tiver sugestões de melhoria, não hesite em abrir uma **issue**. Vamos melhorar o **NLW Agents** juntos!