What is Moorcheh?
Moorcheh is a lightning-fast semantic search engine and vector store. Instead of using simple distance metrics like L2 or Cosine, Moorcheh uses Maximally Informative Binarization (MIB) and Information-Theoretic Score (ITS) to retrieve accurate document chunks. The following tutorial will allow you to use Moorcheh and LangChain to upload and store text documents and vector embeddings as well as retrieve relevant chunks for all of your queries.Key Features
MIB Technology
Uses Maximally Informative Binarization for superior search accuracy
ITS Scoring
Information-Theoretic Score provides better relevance ranking
LangChain Integration
Seamless integration with LangChain ecosystem
Lightning Fast
Optimized for speed and performance
Setup
First, install the necessary package:Initialization
Get started with Moorcheh1
Sign Up
Sign up or log in at the Moorcheh Console
2
Generate API Key
Go to the “API Keys” tab and generate an API key
3
Set Environment Variable
Save the key as an environment variable named
MOORCHEH_API_KEY4
Create Namespace
In the Console, open the “Namespaces” tab and click “Create namespace”; or initialize it programmatically
5
Start Using
Use your API key to create namespaces, upload documents, and retrieve answers
For more information about the Moorcheh SDK functions, see the GitHub repository.
Importing Packages
Import the required packages:Code Setup
Set your Moorcheh API Key in your environment variables:Adding Documents
Create and add documents to your vector store:Delete Documents
Remove documents from your vector store:Query Engine
Once your namespace has been created and you have uploaded documents into it, you can ask queries about the documents directly through the vector store. Set the query and LLM you would like to answer your query.For more information on supported LLMs, please visit our Github page.
Advanced Usage
Custom Embeddings
You can use custom embeddings with Moorcheh:Search with Similarity
Search for similar documents:Search with Score
Get similarity scores along with results:Configuration Options
Namespace Types
Moorcheh supports two namespace types:Text Namespace
Store and search text documents with automatic embedding generation
Vector Namespace
Store pre-computed vector embeddings for custom use cases
AI Models
Supported AI models for generative answers:anthropic.claude-sonnet-4-20250514-v1:0- Claude Sonnet 4anthropic.claude-sonnet-4-5-20250929-v1:0- Claude Sonnet 4.5meta.llama4-maverick-17b-instruct-v1:0- Llama 4 Maverick 17Bmeta.llama3-3-70b-instruct-v1:0- Llama 3.3 70Bamazon.nova-pro-v1:0- Amazon Nova Prodeepseek.r1-v1:0- DeepSeek R1openai.gpt-oss-120b-1:0- OpenAI GPT OSS 120Bqwen.qwen3-32b-v1:0- Qwen 3 32B
Best Practices
Document Preparation
1
Clean Your Data
Remove unnecessary whitespace and format text consistently
2
Add Metadata
Include relevant metadata for better filtering and organization
3
Chunk Appropriately
Split large documents into meaningful chunks
4
Use Unique IDs
Generate unique identifiers for each document
Performance Optimization
- Use appropriate chunk sizes (typically 500-1000 characters)
- Batch document uploads for better performance
- Monitor your API usage and rate limits
- Use caching for frequently accessed data
Error Handling
Troubleshooting
Common Issues
API Key Issues
API Key Issues
- Ensure your API key is correctly set in environment variables
- Check that the API key has the necessary permissions
- Verify the API key is not expired
Namespace Problems
Namespace Problems
- Make sure the namespace exists before adding documents
- Check that the namespace type matches your use case
- Verify you have access to the namespace
Document Upload Errors
Document Upload Errors
- Check document format and content
- Ensure all required fields are present
- Verify document IDs are unique
Debug Mode
Enable debug logging to troubleshoot issues:Further Resources
For more information about Moorcheh, explore these resources:GitHub Repository
Source code and detailed documentation
Examples Repository
Practical examples and tutorials
Official Website
Learn more about Moorcheh’s capabilities
Documentation
Complete API documentation
YouTube Channel
Video tutorials and demos
Follow on X
Stay updated with latest news
Support
Need help with the LangChain integration?Get Support
Contact our support team for assistance