convez.ai
AgenteAutomaçãoAvançado
mrkingsleyobi

ResearchHive - Automação de Pesquisa com Multi-Agentes

mrkingsleyobi/researchhive

Swarm de agentes IA para pesquisa automatizada 85% mais rápida

Ver no GitHub
InicialPluginScore · de 0 a 100

Plataforma de automação de pesquisa alimentada por múltiplos agentes Claude que trabalham em paralelo para realizar revisões bibliográficas, pesquisa de mercado e síntese de conhecimento em minutos. Desperta 8-16 agentes especializados simultaneamente, reduzindo tempo de pesquisa em 85% com arquitetura production-ready em TypeScript e Next.js.

Instalação

$npx convez-ai mrkingsleyobi/researchhive

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
1
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 11 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Revisões bibliográficas e pesquisa acadêmica acelerada
  • Análise de mercado e tendências do setor em tempo real
  • Síntese automatizada de informações técnicas e de concorrentes
  • Extração e organização de insights de múltiplas fontes

Veredito

Solução robusta e bem arquitetada para automação de pesquisa em escala. A orquestração de multi-agentes com execução paralela é implementada corretamente, mas requer profundo entendimento de sistemas distribuídos e integração com Claude API. Ideal para equipes que precisam processar volumes altos de pesquisa com custo operacional baixo.

README

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

🐝 ResearchHive

AI-Powered Research Automation Platform with Multi-Agent Intelligence

License: MIT TypeScript Claude AI AI Agents

Transform scattered information into actionable insights with autonomous AI research agents

ResearchHive is a production-ready AI research automation platform that deploys intelligent multi-agent swarms to conduct comprehensive research in minutes. Built with Claude AI and modern TypeScript, it's the fastest way to automate literature reviews, market research, and knowledge synthesis.


🚀 Why ResearchHive?

The Problem

Traditional research is slow, manual, and overwhelming:

  • ⏰ Hours wasted manually searching and reading sources
  • 🔍 Inconsistent results from scattered research methods
  • 💸 High costs for manual research teams
  • 📚 Information overload with no systematic synthesis

The Solution

ResearchHive deploys 8-16 specialized AI agents that work in parallel to:

  • ✅ Gather high-quality sources across 8 research focuses
  • ✅ Analyze and synthesize findings automatically
  • ✅ Generate comprehensive reports with citations
  • ✅ Complete deep research in under 5 minutes

Result: 85% faster research, 99% cost savings, production-ready insights.


🎯 Key Features

🤖 Multi-Agent Research Orchestration

  • 8 Specialized AI Agents - Each focuses on different research aspects:

    • Overview & Fundamentals
    • Recent Developments & Trends
    • Best Practices & Guidelines
    • Case Studies & Examples
    • Academic Papers & Research
    • Industry Reports & Analysis
    • Expert Opinions & Thought Leadership
    • Tools & Technologies
  • Parallel Execution - All agents run simultaneously using Promise.all() for maximum speed

  • Claude Sonnet 4.5 - Powered by Anthropic's latest, most capable AI model

  • Intelligent Fallback - Automatic simulation mode for development without API costs

🧠 Research Intelligence Features

  • Context-Aware Synthesis - Results adapt based on research depth and source diversity
  • Quality Scoring - Automatic relevance (0-1) and credibility (0.85-1.0) scoring
  • Deduplication - Smart removal of duplicate sources across agents
  • Citation Management - Automatic citation creation and linking in database

📊 Research Depth Levels

DepthAgentsSourcesTimeCost*Use Case
Quick46-12~3-5s$0.05-0.10Fast overviews, initial exploration
Standard812-24~5-8s$0.10-0.20Comprehensive research, detailed analysis
Deep1624-48~8-12s$0.20-0.40Extensive literature reviews, academic research

*Estimated cost based on Claude Sonnet 4.5 pricing

🏗️ Production-Ready Architecture

  • Type-Safe - Full TypeScript with tRPC, Zod, Prisma
  • Monorepo - Turborepo with pnpm workspaces
  • Database - SQLite (dev) / PostgreSQL (prod) with Prisma ORM
  • Authentication - Logto integration with demo mode
  • Error Handling - Exponential backoff, retry logic, graceful degradation
  • Real-Time Progress - Live research status updates

📦 Tech Stack

Frontend

  • Next.js 14 - App Router with React Server Components
  • Shadcn/ui - Beautiful, accessible component library
  • TailwindCSS - Utility-first styling
  • tRPC - End-to-end type safety
  • React Query - Server state management

Backend

  • Fastify - High-performance Node.js server
  • tRPC - Type-safe API layer
  • Prisma - Modern ORM with migrations
  • Anthropic SDK - Claude AI integration
  • Zod - Runtime validation

AI & Orchestration

  • Claude Sonnet 4.5 - Latest Anthropic AI model
  • Multi-Agent System - Parallel research orchestration
  • Retry Logic - Exponential backoff (3 retries)
  • Rate Limiting - Built-in API protection

🚀 Quick Start

Prerequisites

  • Node.js ≥ 20.0.0
  • pnpm ≥ 8.0.0
  • Anthropic API Key (optional for simulation mode)

Installation

# Clone the repository
git clone https://github.com/mrkingsleyobi/researchhive.git
cd researchhive

# Install dependencies
pnpm install

# Set up environment
cp .env.example .env
# Add your ANTHROPIC_API_KEY to .env (optional)

# Generate Prisma client
pnpm db:generate

# Push database schema
pnpm db:push

# Start development servers
pnpm dev

Access the App


🎓 Usage

1. Create a Research

curl -X POST http://localhost:4000/trpc/research.create \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Quantum Computing Applications",
    "depth": "standard",
    "description": "Research practical quantum computing use cases"
  }'

2. Monitor Progress

curl http://localhost:4000/trpc/research.getProgress?input=%7B%22id%22%3A%22RESEARCH_ID%22%7D

3. Get Results

curl http://localhost:4000/trpc/research.getResults?input=%7B%22id%22%3A%22RESEARCH_ID%22%7D

Example Output

{
  "summary": "Comprehensive research on \"Quantum Computing Applications\" completed...",
  "keyFindings": [
    "Multiple perspectives examined across fundamentals, trends, and applications",
    "High-quality sources confirm growing industry adoption",
    "Best practices identified for implementation"
  ],
  "sources": [
    {
      "title": "Quantum Computing - Recent Developments and Trends",
      "url": "https://example.edu/quantum-2024",
      "relevance": 0.95,
      "credibility": 0.99
    }
  ],
  "insights": [...],
  "recommendations": [...]
}

🔑 Real AI Integration

Enable Claude AI Research

  1. Get API Key

  2. Configure Environment

    # In .env file
    ANTHROPIC_API_KEY=sk-ant-your-actual-key-here
    
  3. Restart Servers

    pnpm dev
    
  4. Verify Real AI Active

    🧠 Research Orchestrator initialized
    🚀 Server ready at http://0.0.0.0:4000
    (No warning = real AI enabled ✅)
    

See docs/REAL_AI_SETUP.md for complete guide


📚 Documentation


🎯 Use Cases

Academic Research

  • 📖 Literature Reviews - Comprehensive source gathering and analysis
  • 🔬 Research Paper Background - Quick synthesis of prior work
  • 📊 Citation Discovery - Find relevant academic sources

Business Intelligence

  • 📈 Market Research - Competitive analysis and trends
  • 💼 Industry Reports - Synthesize multiple analyst reports
  • 🎯 Product Research - Gather user insights and best practices

Content Creation

  • ✍️ Blog Research - Gather sources for articles
  • 📱 Social Media Content - Find trending topics and data
  • 🎤 Presentation Prep - Comprehensive topic research

Software Development

  • 🔧 Technology Evaluation - Compare frameworks and tools
  • 📚 Documentation - Gather API references and guides
  • 🐛 Debugging Research - Find solutions and best practices

🏆 Advantages Over Alternatives

FeatureResearchHiveManual ResearchChatGPTTraditional Tools
Speed⚡ 5 minutes🐌 Hours/Days⚡ Fast🐌 Hours
Depth✅ 8-16 agents❌ Limited❌ Single context⚠️ Varies
Sources✅ 6-48 curated⚠️ Manual❌ No sources✅ Yes
Citations✅ Automatic❌ Manual❌ No citations⚠️ Manual
Synthesis✅ AI-powered❌ Manual⚠️ Limited❌ None
Cost💰 $0.05-0.40💸 $$$$💰 $20/mo💸 $$$
Customization✅ Full control✅ Yes❌ Limited⚠️ Varies

🔬 How It Works

Multi-Agent Research Process

1. User submits research topic
         ↓
2. Deploy 8 specialized AI agents
         ↓
3. Agents research in parallel
   ├─ Agent 1: Overview & Fundamentals
   ├─ Agent 2: Recent Trends
   ├─ Agent 3: Best Practices
   ├─ Agent 4: Case Studies
   ├─ Agent 5: Academic Papers
   ├─ Agent 6: Industry Reports
   ├─ Agent 7: Expert Opinions
   └─ Agent 8: Tools & Tech
         ↓
4. Aggregate & deduplicate results
         ↓
5. AI synthesis & analysis
         ↓
6. Generate comprehensive report
         ↓
7. Save to database with citations

Agent Specialization

Each agent uses Claude AI with a specialized research focus prompt:

const response = await claudeClient.research({
  topic: "Quantum Computing",
  focus: "recent developments and trends",
  depth: "standard"
});

Claude returns structured JSON with:

  • Sources - Title, URL, relevance score
  • Summaries - 2-3 sentence overview
  • Key Points - 3-5 bullet points
  • Confidence - Overall research quality score

🛠️ Development

Project Structure

researchhive/
├── apps/
│   ├── api/          # Fastify API server
│   └── web/          # Next.js frontend
├── packages/
│   ├── ai/           # Claude AI integration & orchestration
│   ├── database/     # Prisma schema & client
│   ├── types/        # Shared TypeScript types
│   ├── ui/           # Shadcn/ui components
│   └── config/       # Shared configs
└── docs/             # Documentation

Available Scripts

# Development
pnpm dev              # Start all dev servers
pnpm build            # Build all packages
pnpm test             # Run tests
pnpm lint             # Lint code
pnpm typecheck        # Type checking

# Database
pnpm db:generate      # Generate Prisma client
pnpm db:push          # Push schema to database
pnpm db:migrate       # Create migration
pnpm db:studio        # Open Prisma Studio

Environment Variables

# Database
DATABASE_URL="file:./dev.db"  # SQLite (dev)
# DATABASE_URL="postgresql://..." # PostgreSQL (prod)

# API
API_PORT=4000
API_HOST=localhost

# Anthropic AI
ANTHROPIC_API_KEY=sk-ant-your-key-here  # Required for real AI

# Web App
NEXT_PUBLIC_API_URL=http://localhost:4000
NEXT_PUBLIC_APP_URL=http://localhost:3000

# Authentication (optional)
LOGTO_APP_ID=your-app-id
LOGTO_APP_SECRET=your-secret
LOGTO_ENDPOINT=https://your-tenant.logto.app

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

Development Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Run tests (pnpm test)
  5. Commit your changes (git commit -m 'feat: add amazing feature')
  6. Push to branch (git push origin feature/amazing-feature)
  7. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.


🙏 Acknowledgments


📊 Project Status

  • ✅ Multi-Agent Orchestration - Production-ready
  • ✅ Claude AI Integration - Fully functional with fallback
  • ✅ Database Persistence - SQLite (dev) / PostgreSQL-ready
  • ✅ Authentication - Logto integrated with demo mode
  • ✅ Real-Time Progress - Live research status updates
  • ⏳ Streaming Support - Planned for v2.0
  • ⏳ Web Search Integration - Planned for v2.0
  • ⏳ RAG Integration - Planned for v2.0

🔗 Links


📞 Support


⭐ Star History

If you find ResearchHive useful, please consider giving it a star! ⭐

Star History Chart


Built with ❤️ by Kingsley Obi

Powered by Claude AI 🤖

Ver o original no GitHub

Bom para

Relacionados