Skip to main content

Local-first reasoning pipeline wrapper for Ollama and LM Studio

Project description

🧠 MultiMind AI

A local-first web UI that adds a reasoning pipeline on top of small local models.

Python Version PyPI Version Local First Ollama Supported LM Studio Supported

Image


MultiMind AI acts as an intelligent reasoning pipeline for your local AI models. It effortlessly auto-discovers endpoints like Ollama and LM Studio (OpenAI-compatible) and lets you orchestrate dedicated models for different logical phases: Planning, Execution, and Critique.


✨ Features

  • 🧠 Adaptive Reasoning Modes: Toggle between Off, Medium, and Hard modes to dictate the depth of the model's reflection.
  • 🔌 Zero-Config Auto-Discovery:
    • Automatically hooks into local Ollama endpoints (http://127.0.0.1:11434).
    • Supports optional discovery for LM Studio (http://127.0.0.1:1234).
  • 🎯 Precision Model Mapping: Assign distinct models to handle the different stages of thought (plan, execute, and critique).
  • 💬 Immersive UI: Enjoy a streaming timeline interface with collapsible "thought blocks" to keep your UI clean while the AI thinks.
  • 📝 Native Markdown & Math Support:
    • Final outputs are beautifully rendered as HTML in the chat view.
    • Inline and block math equations are flawlessly typeset using a bundled local KaTeX build.
  • ⚡ Frictionless Setup: Purely in-memory settings. Zero .env setup required for your first run.

🚀 Quick Start

Get up and running in your local environment in seconds:

# 1. Install the package via pip
pip install multimind

# 2. Launch the application
multimind
🛠 Setting up for Development / Source Install
# 1. Clone the repository
git clone https://github.com/JitseLambrichts/MultiMind-AI.git
cd MultiMind-AI

# 2. Create a virtual environment
python3 -m venv .venv

# 3. Activate the virtual environment
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# 4. Install the package in editable mode
pip install -e .

# 5. Launch the application
multimind

Next: Open your browser and navigate to http://127.0.0.1:8000 🎉

🔌 Supported Backends

MultiMind AI works seamlessly with standard local APIs:

  • Ollama: Connects via /api/chat and /api/tags
  • OpenAI-Compatible Servers (e.g., LM Studio): Connects via /v1/chat/completions and /v1/models

If no provider is automatically detected, you can easily point the backend to your local OpenAI-compatible endpoint using the application's settings panel.

💡 How It Works

MultiMind AI splits inference into modular steps, elevating the capabilities of standard models:

  1. Plan: Formulates a structured approach to the prompt.
  2. Execute: Generates the primary response.
  3. Critique (Hard Mode): Evaluates the execution pass as a rough draft and streams refined, critiqued output as the final answer.

📝 Note: Chat history is intentionally in-memory only for the current MVP.

📊 Benchmarks

We evaluated the performance of MultiMind AI's reasoning pipeline using a subset of 20 questions from the GSM8K dataset. The results demonstrate a clear improvement in model accuracy when utilizing the different reasoning modes.

Image

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

multimind-0.1.5.tar.gz (1.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

multimind-0.1.5-py3-none-any.whl (1.5 MB view details)

Uploaded Python 3

File details

Details for the file multimind-0.1.5.tar.gz.

File metadata

  • Download URL: multimind-0.1.5.tar.gz
  • Upload date:
  • Size: 1.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for multimind-0.1.5.tar.gz
Algorithm Hash digest
SHA256 a4a88215c27e2c00c7514c8459852b9b01f5e7d94a8fe5ac6358624d17700abd
MD5 2cd6893a77afd772c2f62e5f5cefacd8
BLAKE2b-256 060474d97574e21917875fb38b796db949bfd918a985e79984098522a5764dc3

See more details on using hashes here.

File details

Details for the file multimind-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: multimind-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 1.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for multimind-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c80dc0209ce475e20fd48c4536f364a48dd55802d4fab3adc0de27bf875cbf19
MD5 50433672c38731830be43c3336ba39c8
BLAKE2b-256 7d322187c22ea1806ee4054a563191512bfd46732d127ad4ea822ebe7a3feab4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page