cerevox 0.2.0

Official Python SDK for Cerevox - The Data Layer for AI Agents: data parsing (Lexa) and data search (Hippo)

Cerevox - The Data Layer for AI Agents 🧠 ⚡

Data Parsing (Lexa) • Data Search (Hippo) • Enterprise-grade • Built for AI
AI-powered • Highest Accuracy • Vector DB ready

Official Python SDK for:

• Lexa - Parse documents into structured data

  • 🎯 Perfect for: RAG applications, document analysis, data extraction, and vector database preparation

• Hippo - Search and query your document collections

  • 🎯 Perfect for: AI-powered Q&A, semantic search, and drawing insights from document collections

• Account - Enterprise user management and authentication

  • 🎯 Perfect for: User authentication, account management, and usage tracking

Table of Contents

• Installation
• Lexa Quick Start
• Hippo Getting Started
• Features
• Examples
• Documentation
• Support

📦 Installation

pip install cerevox

📋 Requirements

• Python 3.9+
• API key from Cerevox

🚀 Lexa Quick Start

Basic Usage

from cerevox import Lexa

# Parse a document
client = Lexa(api_key="your-api-key")
documents = client.parse(["document.pdf"])

print(f"Extracted {len(documents[0].content)} characters")
print(f"Found {len(documents[0].tables)} tables")

Async Processing (Recommended)

import asyncio
from cerevox import AsyncLexa

async def main():
    async with AsyncLexa(api_key="your-api-key") as client:
        documents = await client.parse(["document.pdf", "report.docx"])
        
        # Get chunks optimized for vector databases
        chunks = documents.get_all_text_chunks(target_size=500)
        print(f"Ready for embedding: {len(chunks)} chunks")

asyncio.run(main())

🚀 Hippo Getting Started

• Create Folder and Upload Files
• Start Chat to Ask Questions on the Folder Data

See guide hippo-getting-started.md

✨ Features

🚀 Performance & Scale

• 10x Faster than traditional solutions
• Native Async Support with concurrent processing
• Enterprise-grade reliability with automatic retries

🧠 AI-Powered Extraction

• SOTA Accuracy with cutting-edge ML models
• Advanced Table Extraction preserving structure and formatting
• 12+ File Formats including PDF, DOCX, PPTX, HTML, and more

🔗 Integration Ready

• Vector Database Optimized chunks for RAG applications
• 7+ Cloud Storage integrations (S3, SharePoint, Google Drive, etc.)
• Framework Agnostic works with Django, Flask, FastAPI
• Rich Metadata extraction including images, formatting, and structure

📋 Examples

Explore comprehensive examples in the examples/ directory:

Lexa

Example	Description
lexa_examples.py	Complete SDK functionality demonstration
lexa_async_examples.py	Advanced async processing techniques
lexa_cloud_integrations.py	Cloud storage service integrations

Document

Example	Description
document_examples.py	Document analysis and manipulation features
document_vector_db_preparation.py	Vector database chunking and integration patterns

🚀 Run Examples

# Clone and explore
git clone https://github.com/CerevoxAI/cerevox-python.git
cd cerevox-python

export CEREVOX_API_KEY="your-api-key"

# Run demos
python examples/lexa_examples.py            # Basic usage
python examples/lexa_async_examples.py      # Async features
python examples/lexa_cloud_integrations.py  # Cloud Integrations Coming Soon!

python examples/document_examples.py               # Document analysis
python examples/document_vector_db_preparation.py  # Vector DB integration

📚 Documentation

📖 API References

• API Reference - Complete API documentation

📖 Guides & Tutorials

• Vector Database Integration - RAG and vector DB setup
• Advanced Examples - Real-world usage patterns
• Migration Guide - Migrate from other tools

🔗 External Resources

• Full Documentation - Comprehensive guides
• Interactive API Docs - Try the API
• Discord Community - Get help and discuss

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

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

🆘 Support & Community

📖 Resources Documentation API Reference Examples Changelog

💬 Get Help Discord Community GitHub Discussions Stack Overflow Email Support

🐛 Issues Bug Reports Feature Requests Performance Security Issues

---

⭐ Star us on GitHub if Cerevox helped your project!
Made with ❤️ by the Cerevox team
Happy Building! 🔍 🦛 ✨