multimind-sdk
multimind-sdk copied to clipboard
Your SDK solves all of this. One interface. Unified logic. Local + hosted models. Fine-tuning. Agent tools. Enterprise-ready. Hybrid RAG.Star ๐ if you like it!

MultiMind SDK: The Future of AI Development
๐ Multi-Model AI โข RAG Systems โข Vector Databases โข Agent Framework โข Fine-Tuning โข Enterprise Compliance
Transparent, honest, and production-ready AI development toolkit
๐ง Project Status: In Active Development ๐ง
Join the future of AI development! We're actively building MultiMind SDK and looking for contributors. Check our to see what's implemented and what's coming next. Connect with our growing community on Discord to discuss ideas, get help, and contribute to the project.
What is MultiMind SDK? โข Key Features โข Compliance โข Quick Start โข Documentation โข Examples โข Contributing
๐ค What is MultiMind SDK?
MultiMind SDK is a unified AI development framework that combines practical AI tools with a clean, extensible architecture. We're building a production-ready toolkit for AI developers, with transparency about what works today and what's coming next.
๐ What Makes MultiMind SDK Special
- ๐ฏ Unified API: One interface for multiple AI models and providers
- ๐ Production-Ready RAG: Working RAG pipelines with popular vector databases
- ๐ค Agent Framework: Build AI agents with tools, memory, and orchestration
- โก Multiple Vector DBs: Support for FAISS, Chroma, Weaviate, Qdrant, Pinecone, and more
- ๐จ Fine-Tuning Support: Tools for fine-tuning transformer and non-transformer models
- ๐ Compliance Features: Basic compliance framework for healthcare and enterprise use
๐ Transparency: We're committed to honesty about feature status. See FEATURES.md for detailed status of all features, and ROADMAP.md for our development priorities.
๐ฏ For Beginners
- No AI Experience Required: Start building AI applications with simple Python code
- Pre-built Components: Use ready-made AI tools without understanding complex algorithms
- Step-by-step Examples: Learn AI development through practical examples
- Visual Interface: Use our web-based playground to experiment with AI
๐ For Developers
- Unified Framework: One toolkit for all AI development needs
- Production Ready: Built-in monitoring, logging, and deployment tools
- Extensible: Add your own custom AI components easily
- Type Safe: Modern Python with full error checking and validation
๐ข For Enterprises
- Enterprise Compliance: Built-in support for HIPAA, GDPR, and other regulations
- Scalable Architecture: Handle millions of users and requests
- Cost Optimization: Intelligent resource management and cost tracking
- Security First: Authentication, encryption, and audit trails
โ What Works Today
๐ฏ Core Features (Production Ready)
- โ
Multi-Model AI Chat: OpenAI, Claude, Ollama, Mistral support
- Example:
examples/api/multi_model_wrapper.py
- Example:
- โ
Basic RAG Systems: FAISS, Chroma, and basic vector database support
- Example:
examples/rag/rag_example.py
- Example:
- โ
AI Agents: Basic agents with tools and memory
- Example:
examples/cli/basic_agent.py
- Example:
- โ
CLI Interface: Comprehensive command-line tools
- Example:
examples/cli/(14/14 tests passing)
- Example:
- โ
Memory Management: Buffer, summary, and basic memory types
- Example:
examples/memory/basic_usage.py
- Example:
- โ
Basic Compliance: Healthcare compliance framework
- Example:
examples/compliance/healthcare_compliance_example.py
- Example:
- โ
Context Transfer: Transfer conversations between models
- Example:
examples/context_transfer/chrome_extension_example.py
- Example:
๐ Full Status: See FEATURES.md for complete feature status with badges (โ Stable | ๐ง Beta | ๐ Planned)
โจ Key Features
๐ง AI Model Management โ Stable / ๐ง Beta
- โ
Model Integrations: OpenAI, Claude, Ollama, Mistral
- Example:
examples/api/model_wrapper.py
- Example:
- โ
Multi-Model Wrapper: Unified interface for multiple models
- Example:
examples/api/multi_model_wrapper.py
- Example:
- ๐ง Model Routing: Basic routing between models
- Example:
examples/api/ensemble_api.py
- Example:
- ๐ง Mixture-of-Experts (MoE): Basic implementation
- Example:
examples/moe/
- Example:
- ๐ 100+ Model Support: Many models planned, not yet implemented
- ๐ Federated Learning: Not implemented
- ๐ Model Compression: Basic support only
๐ RAG & Vector Databases โ Stable / ๐ง Beta
- โ
FAISS: Fully functional local vector store
- Example:
examples/vector_store/
- Example:
- โ
Chroma: Complete implementation
- Example:
examples/rag/rag_example.py
- Example:
- ๐ง Weaviate: Basic implementation
- ๐ง Qdrant: Core functionality
- ๐ง Pinecone: Working but basic
- ๐ง Milvus: Functional but limited
- ๐ง Elasticsearch: Basic implementation
- โ
Basic RAG Pipeline: Core RAG with document processing
- Example:
examples/rag/rag_example.py
- Example:
- ๐ง Advanced RAG: Enhanced retrieval features
- Example:
examples/rag/rag_advanced_example.py
- Example:
- ๐ Hybrid RAG: Knowledge graph integration not functional
- ๐ 60+ Vector Databases: Only ~8-10 actually implemented (see FEATURES.md)
๐ค AI Agents โ Stable / ๐ง Beta
- โ
Basic Agents: Agent class with tool support
- Example:
examples/cli/basic_agent.py
- Example:
- โ
Agent Registry: Agent registration and management
- Example:
examples/agents/agent_registry_example.py
- Example:
- โ
ReAct Toolchain: ReAct pattern implementation
- Example:
examples/agents/react_toolchain_example.py
- Example:
- ๐ง Multi-Agent Orchestration: Basic coordination
- ๐ Self-Evolving Agents: Learning mechanisms not implemented
- ๐ Cognitive Scratchpad: Advanced features missing
๐ง Memory Systems โ Stable / ๐ง Beta / ๐ Planned
- โ Buffer Memory: Working conversation buffer
- โ Summary Memory: Working summarization
- โ
Agent Memory: Agent state management
- Example:
examples/memory/basic_usage.py
- Example:
- ๐ง Vector Store Memory: Working but limited
- ๐ง Episodic Memory: Basic implementation
- ๐ง Hybrid Memory: Multi-memory routing
- Example:
examples/memory/advanced_memory_manager.py
- Example:
- ๐ Quantum Memory: Simulation only (not real quantum hardware)
- Note: Educational/research use only
- Example:
examples/memory/quantum_memory.py
๐ Fine-Tuning ๐ง Beta
- ๐ง Basic LoRA: Basic LoRA support
- Example:
examples/fine_tuning/
- Example:
- ๐ง Non-Transformer Models: Mamba, RWKV, Hyena support
- Example:
examples/non_transformer/
- Example:
- ๐ QLoRA: Placeholder only
- ๐ Advanced Optimization: Many techniques not implemented
๐ก๏ธ Compliance & Security โ Stable / ๐ง Beta / ๐ Planned
- โ
Basic Compliance: Healthcare compliance framework
- Example:
examples/compliance/healthcare/
- Example:
- ๐ง GDPR Support: Basic features
- ๐ Zero-Knowledge Proofs: Dependencies not available
- ๐ Differential Privacy: Not implemented
- ๐ Federated Compliance: Not implemented
- ๐ Quantum-Safe Encryption: Not implemented
๐ Workflow & Orchestration โ Stable / ๐ง Beta / ๐ Planned
- โ
Prompt Chains: Basic chaining
- Example:
examples/cli/prompt_chain.py
- Example:
- โ
Task Runner: Simple task execution
- Example:
examples/cli/task_runner.py
- Example:
- ๐ง MCP (Model Context Protocol): Basic executor
- Example:
examples/mcp/
- Example:
- ๐ง Pipeline Builder: Basic pipeline construction
- Example:
examples/pipeline/pipeline_example.py
- Example:
- ๐ Visual Workflow Builder: Not implemented
- ๐ Event-Driven Architecture: Not fully implemented
๐ Monitoring ๐ง Beta / ๐ Planned
- ๐ง Basic Logging: TraceLogger and basic metrics
- ๐ง Usage Tracking: Basic usage tracking
- Example:
examples/cli/usage_tracking.py
- Example:
- ๐ Real-time Performance Tracking: Not implemented
- ๐ AI-Powered Anomaly Detection: Not implemented
- ๐ Cost Optimization Engine: Not implemented
๐ Quick Start
Installation
# Basic installation
pip install multimind-sdk
# With compliance support
pip install multimind-sdk[compliance]
# With development dependencies
pip install multimind-sdk[dev]
# With gateway support
pip install multimind-sdk[gateway]
# Full installation with all features
pip install multimind-sdk[all]
Environment Setup
Copy the example environment file and add your API keys and configuration values:
cp examples/multi-model-wrapper/.env.example examples/multi-model-wrapper/.env
Note: Never commit your
.envfile to version control. Only.env.exampleshould be tracked in git.
๐ฏ Simple Examples for Everyone
For Beginners: Multi-Model AI Chat
from multimind.models import OpenAIModel, ClaudeModel
# Create AI models
gpt_model = OpenAIModel(model="gpt-3.5-turbo")
claude_model = ClaudeModel(model="claude-3-sonnet")
# Chat with AI
response = await gpt_model.generate("Explain AI in simple terms")
print(response)
For Developers: Basic RAG System
from multimind.rag import RAGPipeline
from multimind.vector_store import ChromaVectorStore
from multimind.models import OpenAIModel
# Create a RAG system with Chroma
rag = RAGPipeline(
vector_store=ChromaVectorStore(),
model=OpenAIModel(model="gpt-3.5-turbo")
)
# Add documents
await rag.add_documents([
"MultiMind SDK is a powerful AI development toolkit",
"It supports multiple vector databases and AI models",
"RAG systems help retrieve relevant context for AI responses"
])
# Query with context
results = await rag.query("What is MultiMind SDK?")
print(results)
For Enterprises: Healthcare Compliance
from multimind.compliance import ComplianceMonitor
from multimind.compliance.healthcare import HIPAACompliance
# Create a compliance monitor
compliance = ComplianceMonitor(
organization_id="your_org",
regulations=[HIPAACompliance()]
)
# Check compliance
is_compliant = await compliance.check_compliance(data)
if not is_compliant:
violations = compliance.get_violations()
print(f"Compliance violations: {violations}")
๐ Test Coverage & Current Status
โ Testing Results (Latest)
- Python Version Tested: 3.10.10 โ
- Total Tests: 200
- Passed: 157 (78.5%) โ
- Failed: 10 (5%)
- Skipped: 37 (18.5%)
- Success Rate: 78.5% โ
๐งช Test Categories Performance
- Core Functionality: โ 100% working
- CLI Examples: โ 14/14 tests passing
- API Examples: โ 15/16 tests passing
- Compliance Examples: โ ๏ธ 12/15 tests passing
- Advanced Features: โ ๏ธ 70% working
๐ Production-Ready Features (โ Stable)
- โ Multi-model AI chat with OpenAI, Claude, Ollama, Mistral
- โ Basic AI agents with memory and tools
- โ RAG (Retrieval-Augmented Generation) systems with FAISS and Chroma
- โ Basic vector database integrations (FAISS, Chroma, Annoy)
- โ CLI interface for easy interaction (14/14 tests passing)
- โ Basic model conversion and fine-tuning
- โ Basic compliance and security features
- โ Context transfer between models
- โ Basic memory management systems
๐ For detailed feature status: See FEATURES.md for complete status of all features with badges.
๐ง Quick Start for Developers
1. Install MultiMind SDK
# Basic installation
pip install multimind-sdk
# With all features
pip install multimind-sdk[all]
# Development installation
git clone https://github.com/multimind-dev/multimind-sdk.git
cd multimind-sdk
pip install -e ".[dev]"
2. Set Up Environment
# Create .env file with your API keys
echo "OPENAI_API_KEY=your_openai_api_key" > .env
echo "ANTHROPIC_API_KEY=your_anthropic_api_key" >> .env
echo "MISTRAL_API_KEY=your_mistral_api_key" >> .env
3. Test Basic Functionality
# Quick test - Basic AI chat
from multimind import OpenAIModel
model = OpenAIModel(model="gpt-3.5-turbo")
response = await model.generate("Hello, world!")
print(response)
4. Try Working Examples
# Basic agent example
python examples/cli/basic_agent.py
# Multi-model chat
python examples/cli/chat_with_gpt.py
# RAG system
python examples/rag/example_rag.py
# Context transfer
python examples/context_transfer/chrome_extension_example.py
5. Tested and Working Examples
# CLI Examples (14/14 tested and working)
python examples/cli/basic_agent.py
python examples/cli/chat_with_gpt.py
python examples/cli/chat_ollama_cli.py
# API Examples (15/16 tested and working)
python examples/api/ensemble_api.py
python examples/api/compliance_example.py
# Compliance Examples (12/15 tested and working)
python examples/compliance/healthcare/ehr_compliance.py
python examples/compliance/healthcare/clinical_trial_compliance.py
๐ฏ Developer-Friendly Examples
Simple Multi-Model Chat
from multimind.models import OpenAIModel, ClaudeModel
# Create models
models = {
"gpt": OpenAIModel(model="gpt-3.5-turbo"),
"claude": ClaudeModel(model="claude-3-sonnet")
}
# Use models directly
response = await models["gpt"].generate("Hello, world!")
print(response)
AI Agent with Tools
from multimind import Agent, CalculatorTool, OpenAIModel
# Create agent with calculator tool
agent = Agent(
model=OpenAIModel(model="gpt-3.5-turbo"),
tools=[CalculatorTool()],
system_prompt="You are a helpful AI assistant that can perform calculations."
)
# Run tasks
response = await agent.run("What is 123 * 456?")
print(response)
RAG System
from multimind.rag import RAGPipeline
from multimind.vector_store import ChromaVectorStore
# Create RAG system
rag = RAGPipeline(
vector_store=ChromaVectorStore(),
model=OpenAIModel(model="gpt-3.5-turbo")
)
# Add documents
await rag.add_documents(["MultiMind SDK is a powerful AI development toolkit"])
# Query with context
results = await rag.query("What is MultiMind SDK?")
print(results)
๐ณ Docker Quick Start
# Run with Docker
docker-compose up --build
# Access services:
# - MultiMind API: http://localhost:8000
# - Redis: localhost:6379
๐ Documentation
- FEATURES.md โญ - Honest feature status with badges (โ Stable | ๐ง Beta | ๐ Planned)
- ROADMAP.md - Development priorities and future features
- Getting Started Guide - Your first steps with MultiMind SDK
- API Reference - Complete API documentation
- Examples - Ready-to-use code examples
- Compliance Guide - Enterprise compliance features
- Architecture - How MultiMind SDK works
- Contributing Guide - Join our development team
๐ Project Structure
multimind-sdk/
โโโ multimind/ # Core SDK package
โ โโโ core/ # Core AI components
โ โโโ models/ # AI model integrations
โ โโโ rag/ # Document AI system
โ โโโ agents/ # AI agent framework
โ โโโ memory/ # Memory management
โ โโโ compliance/ # Enterprise compliance
โ โโโ cli/ # Command-line tools
โ โโโ gateway/ # Web API gateway
โโโ examples/ # Ready-to-use examples
โ โโโ basic/ # Simple examples for beginners
โ โโโ advanced/ # Complex examples for experts
โ โโโ compliance/ # Compliance examples
โ โโโ streamlit-ui/ # Web interface
โโโ docs/ # Documentation
โโโ tests/ # Test suite
๐ค Contributing
We love your input! We want to make contributing to MultiMind SDK as easy and transparent as possible.
- Contributing Guide - How to contribute
- Code of Conduct - Community guidelines
- Issue Tracker - Report bugs or request features
Development Setup
# Clone the repository
git clone https://github.com/multimind-dev/multimind-sdk.git
cd multimind-sdk
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Start documentation
cd multimind-docs
npm install
npm start
๐ณ Docker Setup
Run MultiMind SDK with Docker for easy deployment:
# Start all services
docker-compose up --build
# Access the web interface
# MultiMind API: http://localhost:8000
# Web Playground: http://localhost:8501
The Docker setup includes:
- MultiMind SDK service
- Redis for caching
- Chroma for document storage
- Ollama for local AI models
๐ Support MultiMind SDK
๐ Help Us Build the Future of AI ๐
MultiMind SDK is free and open-source, but your support helps us keep pushing the boundaries of AI technology.
๐ Why Support MultiMind SDK?
We're building a practical, production-ready AI development framework. Your support enables us to:
- โก Core Development: Complete vector database integrations and improve existing features
- ๐ Security & Compliance: Enhance compliance features and security
- ๐ Documentation & Education: Better tutorials, examples, and learning resources
- ๐ Community Growth: Supporting our growing global community of AI developers
- ๐ ๏ธ Infrastructure: Servers, CI/CD, testing, and development tools
- ๐งช Quality & Testing: Improve test coverage and code quality
๐ Support Tiers
| Tier | Amount | Perks |
|---|---|---|
| ๐ Supporter | $5/month | Name in contributors, early access to features |
| ๐ Builder | $25/month | Priority support, exclusive Discord role, beta access |
| ๐ Champion | $100/month | Custom feature requests, 1-on-1 consultation |
| ๐ Enterprise | $500/month | Dedicated support, custom integrations, white-label options |
๐ฏ What Your Support Funds
- 50% Development: New features, vector database integrations, performance optimization
- 25% Community: Documentation, tutorials, events, Discord community
- 15% Quality: Testing, code quality, bug fixes
- 10% Infrastructure: Servers, CI/CD, testing, development tools
๐ Join Our Mission
Help us democratize AI development and build the future of intelligent systems.
Every contribution, no matter the size, helps us push the boundaries of what's possible with AI.
๐ Other Ways to Support
- โญ Star the Repository: Show your love on GitHub
- ๐ฌ Join Discord: Help other developers and share your ideas
- ๐ Report Issues: Help us improve by reporting bugs
- ๐ Contribute Code: Submit pull requests and improve the codebase
- ๐ Write Documentation: Help make MultiMind SDK more accessible
- ๐ Spread the Word: Share MultiMind SDK with your network
Together, we're building the future of AI development. Thank you for being part of this journey! ๐
๐ License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
For more information about the Apache License 2.0, visit apache.org/licenses/LICENSE-2.0.
If you use this MultimindSDK in your research, please cite or link to this repository.
๐ Support
- Discord Community - Join our active developer community
- GitHub Issues - Get help and report issues
- Documentation - Comprehensive guides
๐ฃ About
MultiMind SDK is developed and maintained by the MultimindLAB team, dedicated to simplifying AI development for everyone. Visit multimind.dev to learn more about our mission to democratize AI development.
Made with โค๏ธ by the AI2Innovate & MultimindLAB Team | License
Ready to Build the Future of AI?
โญ Star on GitHub ๐ฌ Join Discord ๐ Get Started
๐ Learn About Compliance ๐ View Examples
๐ค LLM Metadata
We provide detailed metadata and indexing instructions for LLMs, covering supported models, features, tags, and discoverability tools for MultiMind SDK.