multimind-sdk icon indicating copy to clipboard operation
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 Logo

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

MultiMind SDK License MultiMind SDK GitHub Stars CI Status

๐Ÿšง 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

๐Ÿฆ Follow on X

๐Ÿ’– Support on Open Collective

Join us on Discord

PyPI version Python versions PyPI weekly Downloads Dependencies Code Style: Black License

๐Ÿค– 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
  • โœ… Basic RAG Systems: FAISS, Chroma, and basic vector database support
    • Example: examples/rag/rag_example.py
  • โœ… AI Agents: Basic agents with tools and memory
    • Example: examples/cli/basic_agent.py
  • โœ… CLI Interface: Comprehensive command-line tools
    • Example: examples/cli/ (14/14 tests passing)
  • โœ… Memory Management: Buffer, summary, and basic memory types
    • Example: examples/memory/basic_usage.py
  • โœ… Basic Compliance: Healthcare compliance framework
    • Example: examples/compliance/healthcare_compliance_example.py
  • โœ… Context Transfer: Transfer conversations between models
    • Example: examples/context_transfer/chrome_extension_example.py

๐Ÿ“Š 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
  • โœ… Multi-Model Wrapper: Unified interface for multiple models
    • Example: examples/api/multi_model_wrapper.py
  • ๐Ÿšง Model Routing: Basic routing between models
    • Example: examples/api/ensemble_api.py
  • ๐Ÿšง Mixture-of-Experts (MoE): Basic implementation
    • Example: examples/moe/
  • ๐Ÿ“‹ 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/
  • โœ… Chroma: Complete implementation
    • Example: examples/rag/rag_example.py
  • ๐Ÿšง 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
  • ๐Ÿšง Advanced RAG: Enhanced retrieval features
    • Example: examples/rag/rag_advanced_example.py
  • ๐Ÿ“‹ 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
  • โœ… Agent Registry: Agent registration and management
    • Example: examples/agents/agent_registry_example.py
  • โœ… ReAct Toolchain: ReAct pattern implementation
    • Example: examples/agents/react_toolchain_example.py
  • ๐Ÿšง 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
  • ๐Ÿšง Vector Store Memory: Working but limited
  • ๐Ÿšง Episodic Memory: Basic implementation
  • ๐Ÿšง Hybrid Memory: Multi-memory routing
    • Example: examples/memory/advanced_memory_manager.py
  • ๐Ÿ“‹ 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/
  • ๐Ÿšง Non-Transformer Models: Mamba, RWKV, Hyena support
    • Example: examples/non_transformer/
  • ๐Ÿ“‹ QLoRA: Placeholder only
  • ๐Ÿ“‹ Advanced Optimization: Many techniques not implemented

๐Ÿ›ก๏ธ Compliance & Security โœ… Stable / ๐Ÿšง Beta / ๐Ÿ“‹ Planned

  • โœ… Basic Compliance: Healthcare compliance framework
    • Example: examples/compliance/healthcare/
  • ๐Ÿšง 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
  • โœ… Task Runner: Simple task execution
    • Example: examples/cli/task_runner.py
  • ๐Ÿšง MCP (Model Context Protocol): Basic executor
    • Example: examples/mcp/
  • ๐Ÿšง Pipeline Builder: Basic pipeline construction
    • Example: examples/pipeline/pipeline_example.py
  • ๐Ÿ“‹ 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
  • ๐Ÿ“‹ 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 .env file to version control. Only .env.example should 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

Development 50% Community 25% Quality 15% Infrastructure 10%
  • 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.

Support on OpenCollective

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

๐Ÿ“ฃ 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

LLM Metadata

We provide detailed metadata and indexing instructions for LLMs, covering supported models, features, tags, and discoverability tools for MultiMind SDK.