convez.ai
PluginIntegração & APIsIntermediário
Dardin-dale

Dewey - Bot de Clube do Livro com IA

Dardin-dale/Dewey

Bot Discord com IA para gerenciar clubes de leitura com sinopses e discussões

Ver no GitHub
InicialPluginScore · de 0 a 100

Bot Discord para clubes de leitura que gera sinopses sem spoilers, questões de discussão e recomendações de livros usando IA com busca web em tempo real. Funciona serverless na AWS Lambda com suporte a Gemini e Claude, oferecendo comandos como síncpse, alertas de conteúdo e votações de livros.

Instalação

$npx convez-ai Dardin-dale/Dewey

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar sinopses spoiler-free para decidir que livro ler
  • Criar questões de discussão automáticas para reuniões de clube
  • Listar avisos de conteúdo sensível em livros
  • Obter recomendações personalizadas de livros
  • Fazer votações entre múltiplos livros no Discord

Veredito

Solução bem-arquitetada para comunidades de leitura no Discord, com bom uso de múltiplos provedores de IA e busca web. Implementação serverless competente, mas requer experiência com AWS CDK e Discord API para deploy.

README

A tradução para o português deste README ainda está na fila.

Dewey

A Discord bot for book clubs. Dewey provides spoiler-free synopses, discussion questions, and book recommendations powered by AI with real-time web search.

Features

Slash Commands

  • /synopsis [title] - Get a spoiler-free book synopsis perfect for deciding what to read next
  • /discussion [title] - Generate thought-provoking discussion questions for your book club meeting
    • Spoiler-sensitive details are wrapped in Discord spoiler tags (||like this||)
  • /content-warnings [title] - Get content/trigger warnings for a book
    • Grouped by severity (Major/Moderate/Minor)
    • Spoiler-free format
  • /poll [books] - Create a book poll with synopses thread
    • books: Comma-separated titles (max 10)
    • duration: Poll duration in hours (default: 24, max: 168)
    • multiple: Allow voting for multiple books (default: false)
  • /recommend [based_on] - Get personalized book recommendations based on a title or description
  • /synopsis-batch [titles] [thread] - Get synopses for multiple books at once
    • Accepts comma-separated titles or freeform text (AI extracts book titles)
    • Optional thread:true to create a thread for the synopses
  • /provider status/set - View or switch between AI providers (Gemini/Claude)

Message Commands (Right-Click Menu)

  • Generate Synopses - Right-click any message → Apps → Generate Synopses
    • Extracts book titles from the message and generates synopses
    • Automatically creates a thread attached to the original message

Tech Stack

  • Runtime: AWS Lambda (Node.js 20)
  • Infrastructure: AWS CDK (TypeScript)
  • AI Providers:
    • Google Gemini 3 Flash with Google Search grounding
    • Anthropic Claude Haiku with web search
  • Discord: Slash commands and message commands with deferred responses

Bot Permissions

When adding Dewey to your server, ensure these permissions are granted:

Required Permissions

PermissionReason
Send MessagesReply to commands
Send Messages in ThreadsPost synopses in threads
Create Public ThreadsCreate threads for batch synopses
Read Message HistoryRead target messages for "Generate Synopses" command
Use Application CommandsEnable slash commands

OAuth2 Scopes

  • bot - Required for sending messages and creating threads
  • applications.commands - Required for slash commands and message commands

Invite URL

Generate an invite URL in the Discord Developer Portal → OAuth2 → URL Generator with:

  • Scopes: bot, applications.commands
  • Permissions: Send Messages, Send Messages in Threads, Create Public Threads, Read Message History

Setup

Prerequisites

  • Node.js 20+
  • AWS CLI configured with credentials
  • Discord application with bot token

Environment Variables

Create a .env file:

DISCORD_APP_ID=your_app_id
DISCORD_BOT_PUBLIC_KEY=your_public_key
DISCORD_BOT_SECRET_TOKEN=your_bot_token
DISCORD_SERVER_ID=your_guild_id  # Optional, for instant command registration

GEMINI_API_KEY=your_gemini_key
ANTHROPIC_API_KEY=your_claude_key

Installation

npm install

Deploy

npx cdk deploy

After deploying, set the Interactions Endpoint URL in your Discord application settings to the URL output by the deploy command.

Register Commands

npm run build && npm run register-commands

Development

# Build TypeScript
npm run build

# Deploy changes
npx cdk deploy

# View Lambda logs
aws logs tail /aws/lambda/DeweyStack-DiscordHandler... --follow

Architecture

Dewey uses Discord's deferred response pattern for AI operations:

  1. User sends a slash command
  2. Lambda immediately returns a "thinking..." response
  3. Lambda invokes itself asynchronously to process the request
  4. AI generates response with web search for accurate, up-to-date information
  5. Lambda sends follow-up message(s) to Discord (auto-splits long responses)
Ver o original no GitHub

Bom para

Relacionados