PearAI is a master repository that serves as an inventory and unified interface for integrating leading AI tools into a single platform. The project is structured as a collection of interconnected repositories that together form the complete PearAI ecosystem. The pearai-app repository contains the bulk of editor functionalities and is built as a fork of VSCode, while the pearai-submodule, a fork of Continue, handles the majority of AI chat capabilities. Additional components include the pear-landing-page for user-facing marketing, pearai-documentation for user guides, pearai-server for optional backend services that allow users to avoid managing their own API keys, and pearai-server-issues-public for tracking server-related issues separately.
The technology stack reflects a modern full-stack approach. The core PearAI application is built in TypeScript and Electron.js, enabling cross-platform desktop functionality. The landing page uses Next.js and React with Supabase authentication, styled with TailwindCSS and Shadcn components. The backend infrastructure relies on Python FastAPI with a Supabase database. Logging and telemetry are handled through Axiom and PostHog. Development requires specific tool versions including Node.js 20.18.0, npm 10.8.2, Yarn 1, Python 3.11.X, Rust, and platform-specific C/C++ compiler toolchains.
The repository maintains overlapping contributor relationships with nousresearch/hermes-agent, trycua/cua, and trypear/pearai-app, indicating collaborative development patterns across related projects.
The project is classified across multiple AI and machine learning domains including neural networks, deep learning, AI development, natural language processing, dialogue systems, chatbot frameworks, conversational AI, and algorithm optimization. This broad classification reflects PearAI's goal of curating and integrating diverse AI capabilities into a cohesive user experience.
Development workflow emphasizes accessibility for contributors. The project provides clear prerequisites and installation instructions, with a documented development process that includes launching development servers through VSCode's Run and Debug interface. Hot Module Reload is enabled for React frontends including the Roo Code frontend, creator overlay, and chat pane, allowing developers to see changes without full restarts. The team actively encourages community contributions through GitHub issues and maintains a Discord server for direct communication. Contributors are asked to comment on issues before starting work and are advised to be mindful of upstream compatibility when modifying the VSCode and Roo Code forks.
