Skip to content

Changelog

All notable changes to MiMinions are documented here.

The format follows Keep a Changelog and the project adheres to Semantic Versioning.

Current version

The latest published release is 0.2.2 (requires Python ≥ 3.12). Install it with pip install miminions, or pip install miminions[sqlite] to add SQLite vector memory. See Getting Started for the full matrix.

[Unreleased]

Work in progress toward the next release. Everything below is on main but not yet cut into a versioned tag.

Added

  • Click-based CLI (miminions / python -m miminions) with nine command groups: auth, agent, task, knowledge, workspace, execution, chat, gateway, and prompt. State persists locally under ~/.miminions/. See CLI.
  • First-run bootstrap. miminions.core.bootstrap.ensure_default_setup idempotently creates a default workspace and a default agent record under ~/.miminions/ on first use, so the CLI works out of the box.
  • Three-tier memory with an LLM distiller. A chronological session log (HISTORY.md), stable workspace facts (MEMORY.md → "Project Facts"), and a cross-workspace SQLite vector store (~/.miminions/global_memory.db). MemoryDistiller extracts and promotes insights across tiers using an create_llm_filter-built extractor. See Memory.
  • Workspace system. A node/rule graph model (Workspace, Node, Rule, NodeType, RulePriority) with rule inheritance and priority-sorted evaluation, a JSON-backed WorkspaceManager, and an on-disk layout (prompt/, memory/, skills/, sessions/, data/) scaffolded by init_workspace. See Workspaces.
  • Context injection. ContextBuilder().build(workspace, root_path) composes a single markdown context block (Identity, Tool Boundary, Prompt Files, optional Global Knowledge, Memory, Workspace Graph Summary, Skills Index) that is wired into the agent system prompt via Minion.set_context. See Context.
  • MCP tool loading. Connect to a stdio MCP server with await agent.connect_mcp_server(name, StdioServerParameters(...)) and register its tools with await agent.load_tools_from_mcp_server(name). Uses the mcp package, which is a core dependency. See Agent.
  • Gateway runtime building blocks (miminions.core.gateway): an async pub/sub MessageBus, a BaseChannel abstraction, a JSONL SessionManager, a CronService (one-shot, recurring, and cron-expression schedules; cron expressions require the optional croniter package), and a phased GatewayOrchestrator. Provided as an extensible runtime layer, not a turnkey server. See Gateway.
  • Workflow tracing models (WorkflowTrace, WorkflowRun, ToolCallRecord, AgentRunRecord) and a WorkflowController, persisted by the miminions execution CLI.

Changed

  • Replaced sentence-transformers with fastembed (ONNX Runtime) for SQLiteMemory embeddings, removing the PyTorch/CUDA dependency. Same all-MiniLM-L6-v2 model and 384-dim output, so existing databases need no migration. SQLite vector memory now installs via the [sqlite] (or [all]) extra alongside sqlite-vec and pysqlite3.
  • Simplified the user module to a lean User dataclass (miminions.user.model).

Removed

  • Heavy embedding stack (PyTorch/CUDA) is no longer pulled in for SQLite vector memory.
  • Complex user authentication and validation systems.

Not yet enabled

A workflow CLI command group exists in the tree but is not registered ("not yet implemented"). The --async flag on miminions agent run is currently a no-op placeholder. These are tracked for a future release and are documented as planned, not present.

[0.2.2] - 2026-04-02

Current published release on PyPI.

Added

  • Agent layer built on pydantic_ai: create_minion / Minion with a tool registry, optional vector memory (auto-registering seven memory + ingestion tools), and an async run() reasoning loop.
  • ModelFactory provider selection — openrouter (default, openai/gpt-oss-20b:free), openai, anthropic, gemini, and an offline test model.
  • SQLiteMemory vector store with vector, keyword, full-text, metadata, regex, hybrid, and date-range search, backed by sqlite-vec.
  • GenericTool / @tool / create_tool tool abstraction and an MCP tool adapter.
  • LocalDataManager content-addressable (SHA-256) local storage with deduplication, a JSON master index, and an append-only transaction log.

[0.1.0]

Initial release.

Added

  • Core MiMinions package structure.
  • Generic tool system and agent management foundations.
  • Local data management system.
  • User module with a basic data model.
  • A test suite structure.

Version history

Version Notes
Unreleased CLI, three-tier memory + distiller, workspaces, context builder, MCP loading, gateway building blocks; fastembed embeddings
0.2.2 Current published release — agent, vector memory, tools, local data
0.1.0 Initial release with core functionality

How to read this changelog

Categories

  • Added — new features
  • Changed — changes to existing functionality
  • Deprecated — features slated for removal
  • Removed — features that have been removed
  • Fixed — bug fixes
  • Security — security-related changes

Versioning

We follow Semantic Versioning (MAJOR.MINOR.PATCH):

  • MAJOR — incompatible API changes
  • MINOR — new functionality, backward-compatible
  • PATCH — backward-compatible bug fixes

Contributing

When adding changelog entries:

  1. Add the entry under the appropriate category.
  2. Use clear, concise language.
  3. Reference issue numbers where applicable.
  4. Keep the Unreleased section current as development proceeds.

See Contributing for the full workflow.