Assistente de pesquisa no terminal com IA

Busca na web em tempo real • Respostas com IA • Histórico persistente • Exportável

📚 Documentation • 🚀 Get Started • 💬 GitHub • 🐛 Issues

✨ Features

• ⚡ Ultra Rápido — Modo kunai (rápido) e gear (completo)
• 🔍 Web em Tempo Real — Busca com Firecrawl detecta perguntas recentes
• 💾 Histórico Persistente — Conversas salvas, /search, cache de 24h
• 🎯 Configurável — Temperature, tokens, idioma, modo detalhado
• 📥 Exportável — Salve respostas em Markdown ou JSON
• 🎨 Visual Aprimorado — Syntax highlighting, tabelas, menu interativo com Tab
• 🔄 Follow-up Context — Entende continuações como "qual é a diferença..."

🚀 Getting Started

Quickstart (sem instalar)

npx ryuki

One-shot (sem abrir REPL)

ryuki "quem ganhou a copa do mundo 2022?"

Instalar globalmente

npm install -g ryuki
ryuki

Erro de permissão? Use npx ryuki — não precisa instalar globalmente.

📚 Documentation

Acesse a documentação completa em: ryuki-docs.vercel.app

💻 Modo Interativo

ryuki> o que é Python?
# Busca e responde com IA

ryuki> /set detail=short
# Respostas resumidas (2-3 frases)

ryuki> qual a diferença pra JavaScript?
# Entende o contexto anterior (follow-up)

ryuki> /export markdown
# Salva última resposta

Comandos

| Comando | O que faz | |---------|----------| | /model | Menu interativo: kunai (rápido) ou gear (completo) | | /set detail=short\|full | Modo detalhado | | /export markdown\|json | Exporta última resposta | | /search termo | Busca no histórico | | /set temperature=0.5 | Ajusta criatividade | | /config | Mostra configurações | | /help | Lista de comandos |

Dica: Digite / pra ver menu com autocomplete via Tab

⚙️ Configuration

Na primeira execução, o Ryuki pede duas chaves gratuitas:

1. Firecrawl (busca na web)
2. Groq (IA, 100k tokens/dia grátis)

Salvas em ~/.config/ryuki/config.json (permissão 0600).

Variáveis de ambiente

export FIRECRAWL_API_KEY=your_key
export GROQ_API_KEY=your_key
ryuki

🛠️ Development

git clone https://github.com/EdersonSouza02/ryuki.git
cd ryuki
npm install
node bin/ryuki.js

📄 Licença

MIT © EdersonSouza02

Made with 💜 by @EdersonSouza02

⬆ back to top