🐝 ResearchHive

AI-Powered Research Automation Platform with Multi-Agent Intelligence

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

Depth	Agents	Sources	Time	Cost*	Use Case
Quick	4	6-12	~3-5s	$0.05-0.10	Fast overviews, initial exploration
Standard	8	12-24	~5-8s	$0.10-0.20	Comprehensive research, detailed analysis
Deep	16	24-48	~8-12s	$0.20-0.40	Extensive 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

Web App: http://localhost:3000
API Server: http://localhost:4000
tRPC Endpoint: http://localhost:4000/trpc

🎓 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

Get API Key
- Visit Anthropic Console
- Sign up (free $5 credit included)
- Create new API key

Configure Environment

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

Restart Servers
```
pnpm dev
```

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

Real AI Setup - Complete Claude AI integration guide
Architecture - System design and components
Claude Flow Integration - Alternative AI approaches
Authentication Setup - Logto configuration guide
AI Workflow Validation - Test results and benchmarks

🎯 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

Feature	ResearchHive	Manual Research	ChatGPT	Traditional 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

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

📜 License

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

🙏 Acknowledgments

Anthropic - Claude AI model
Claude-Flow - Inspiration for multi-agent orchestration
Shadcn/ui - Beautiful component library
T3 Stack - Modern TypeScript stack inspiration

📊 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

GitHub: https://github.com/mrkingsleyobi/researchhive
Documentation: https://github.com/mrkingsleyobi/researchhive/tree/main/docs
Issues: https://github.com/mrkingsleyobi/researchhive/issues
Anthropic Claude: https://www.anthropic.com/claude
Claude Console: https://console.anthropic.com

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions

⭐ Star History

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

Built with ❤️ by Kingsley Obi

Powered by Claude AI 🤖

Name		Name	Last commit message	Last commit date
Latest commit History 15 Commits
apps		apps
docs		docs
k8s		k8s
packages		packages
.env.example		.env.example
.gitignore		.gitignore
GETTING_STARTED.md		GETTING_STARTED.md
IMPLEMENTATION.md		IMPLEMENTATION.md
LICENSE		LICENSE
README.md		README.md
RUVNET_ECOSYSTEM_RESEARCH.md		RUVNET_ECOSYSTEM_RESEARCH.md
docker-compose.yml		docker-compose.yml
package-lock.json		package-lock.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
turbo.json		turbo.json

License

mrkingsleyobi/researchhive

Folders and files

Latest commit

History

Repository files navigation