Clearch is a specialized virtual assistant for terminal environments that provides detailed system information. It leverages natural language processing to understand user queries and responds with precise system data extracted from your computer.
With Clearch, you can:
- Query hardware and software information
- Troubleshoot system issues
- Get technical guidance for your specific system
- Obtain step-by-step instructions compatible with your configuration
- Natural Language Understanding: Ask questions in plain English about your system
- Context-Aware Responses: Provides answers based on your actual system specifications
- Technical Accuracy: Extracts precise information about memory, disk space, hardware, etc.
- Formatting for Readability: Presents system data in a clean, formatted style
- Step-by-Step Solutions: Offers troubleshooting guidance tailored to your system
Clearch uses a combination of technologies to deliver accurate responses:
- Vector Database: System information is stored in a Chroma vector database
- Embedding Model: Uses Hugging Face's sentence-transformers for semantic search
- LLM Integration: Leverages Groq's LLMs for intelligent response generation
- RAG (Retrieval Augmented Generation): Combines retrieved system context with powerful LLM capabilities
- Python 3.8+
- pip package manager
- Groq API key (sign up here)
- Clone the repository or download the project files:
git clone https://github.com/yourusername/clearch.git
cd clearch- Install the required dependencies:
pip install -r requirements.txt- Set up your environment variables:
cp .env.example .env- Edit the
.envfile and add your Groq API key:

