Skip to content

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!

License

Notifications You must be signed in to change notification settings

multimindlab/multimind-sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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

πŸ“ 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.

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

πŸ€– LLM Metadata

LLM Metadata

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