Metadata-Version: 2.4
Name: minder-cli
Version: 0.4.1
Summary: Minder CLI is the command-line interface for the Minder self-hosted MCP platform.
Project-URL: Homepage, https://github.com/hiimtrung/minder
Project-URL: Repository, https://github.com/hiimtrung/minder
Project-URL: Documentation, https://github.com/hiimtrung/minder/tree/main/docs
License-File: LICENSE
Keywords: ai,cli,code-search,mcp,workflow
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.14
Requires-Dist: fastapi>=0.136.0
Requires-Dist: httpx>=0.28.0
Provides-Extra: server
Requires-Dist: aiosqlite>=0.21.0; extra == 'server'
Requires-Dist: fastembed>=0.5.1; extra == 'server'
Requires-Dist: langgraph>=1.1.8; extra == 'server'
Requires-Dist: litellm>=1.83.1; extra == 'server'
Requires-Dist: litert-lm-api-nightly>=0.10; extra == 'server'
Requires-Dist: mcp>=1.26.0; extra == 'server'
Requires-Dist: motor>=3.7.0; extra == 'server'
Requires-Dist: passlib[bcrypt]>=1.7.4; extra == 'server'
Requires-Dist: prometheus-client>=0.24.1; extra == 'server'
Requires-Dist: pydantic-settings[toml]>=2.13.1; extra == 'server'
Requires-Dist: pydantic>=2.12.5; extra == 'server'
Requires-Dist: pyjwt>=2.12.1; extra == 'server'
Requires-Dist: pymilvus>=2.6.12; extra == 'server'
Requires-Dist: sqlalchemy[asyncio]>=2.0.49; extra == 'server'
Requires-Dist: yarl>=1.16.0; extra == 'server'
Requires-Dist: zipp>=3.21.0; extra == 'server'
Requires-Dist: zstandard>=0.25.0; extra == 'server'
Description-Content-Type: text/markdown

# Minder

[![PyPI version](https://img.shields.io/pypi/v/minder-cli.svg)](https://pypi.org/project/minder-cli/)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

**Minder** is a self-hosted MCP (Model Context Protocol) platform for repository-aware engineering intelligence.

It combines a local-first inference stack, a persistent memory and workflow engine, and a developer-facing CLI into a single deployable unit.

## What's in this repo

| Component | Description |
|-----------|-------------|
| **Minder Server** | MCP gateway — SSE + stdio transport, RAG pipeline, workflow engine, memory, admin HTTP |
| **Minder CLI** (`minder-cli` on PyPI) | Edge CLI — IDE scaffold, repo sync, login, self-update |
| **Minder Dashboard** | Astro admin console — client management, onboarding, skill catalog |

## Architecture

```
Developer → minder-cli → Minder Server ←→ AI agents (Codex / Copilot / Claude)
                              │
               ┌──────────────┼──────────────┐
               │              │              │
           MongoDB          Redis         Milvus
         (graph/memory)   (cache)      (vector search)
               │
          ┌─────┴──────┐
          │            │
       LiteRT-LM    FastEmbed
       (LLM gen)   (embedding)
```

- **LLM inference**: LiteRT-LM (Google AI Edge) — on-device, hardware-accelerated, no HTTP overhead
- **Embedding inference**: FastEmbed running natively in-process (`mxbai-embed-large-v1`) — zero-dependency ONNX acceleration

## Quick Start

### Run the server

```bash
# 1. Download the LiteRT-LM model
./scripts/download_models.sh

# 2. Start infra (MongoDB + Redis + Milvus)
docker compose -f docker/docker-compose.local.yml up -d

# 3. Run Minder Server
uv run python -m minder.server
```

Or use the one-command release installer (Docker only, no local uv needed):

```bash
curl -fsSL https://raw.githubusercontent.com/hiimtrung/minder/main/scripts/release/install-minder-release.sh | bash
```

### Connect the CLI

```bash
# Install
uv tool install minder-cli

# Log in with your client key
minder login --client-key mkc_your_key --server-url http://localhost:8800/sse

# Set up IDE integration (VS Code, Cursor, Claude Code)
minder install-ide --target vscode --target claude-code

# Sync a repository
minder sync --repo-id <uuid>
```

## MCP Tools

When connected, Minder exposes these tools to your AI agents:

| Tool | Description |
|------|-------------|
| `minder_query` | Full RAG pipeline: retrieve → reason → verify → respond |
| `minder_search_code` | Semantic code search across indexed repos |
| `minder_memory_recall` | Retrieve persisted engineering memory |
| `minder_workflow_get` | Read current workflow state |
| `minder_session_restore` | Restore session continuity across context windows |

## Documentation

- [System Design](docs/system-design.md)
- [Server Setup](docs/minder-server.md)
- [Local Dev Setup](docs/guides/local-setup.md)
- [Production Deployment](docs/guides/production-deployment.md)
- [Admin & Client Onboarding](docs/guides/admin-client-onboarding.md)

## License

Apache License 2.0. See [LICENSE](LICENSE) for details.
