🔍 Searcho AI

Your Intelligent Multi-Agent Research Assistant

Searcho AI is a powerful React web application that leverages a team of 5 specialized AI agents to research, analyze, and vote on the best answers to your questions. It goes beyond simple search results by synthesizing information from multiple sources and providing a consensus-based answer.

✨ Features

• Multi-Agent Architecture: Orchestrates 5 distinct AI agents to tackle complex queries.
• Consensus Voting: Agents vote on the most accurate and comprehensive answer.
• Real-time Research: Scrapes and analyzes live web data for up-to-date information.
• Transparent Process: Watch the agents think, search, and decide in real-time.
• Modern UI: Built with React and Vite for a fast, responsive experience.

🚀 Quick Start

Get up and running in minutes!

Prerequisites

• Node.js (v18+)
• npm

Installation

1. Clone the repo

   git clone https://github.com/UnlimitedBytes/searcho.git
   cd searcho

2. Setup Environment Navigate to the server directory and set up your API key.

   cd server
   cp .env.example .env
   # Edit .env and add your OPENROUTER_API_KEY
   # Optionally set OPENROUTER_MODEL (defaults to openrouter/sherlock-think-alpha)

3. Install & Run From the root directory:

   npm run setup   # Installs dependencies for client and server
   npm start       # Builds client and starts the production server

   Visit http://localhost:3001 to start searching!

🛠️ Development

Want to contribute or modify the code? Run the client and server separately for hot-reloading.

1. Start the Server

   cd server
   npm run dev

2. Start the Client (in a new terminal)

   cd client
   npm run dev

🏗️ Tech Stack

• Frontend: React, Vite, Tailwind CSS (implied by index.css)
• Backend: Node.js, Express
• AI/LLM: OpenRouter (access to GPT-4, Claude, etc.)
• Tools: Playwright/Puppeteer (for web scraping), Cheerio

📄 License

Apache 2.0