micro-models-agent 0.2.30 → 0.2.32

package/README.md

@@ -1,8 +1,26 @@
 # MMA — Micro Models Agent
 
-LLM агент-харнес для маленьких моделей (Qwen3.5-9B, 32K-64K контекст).
-
-Работает с OpenAI-совместимыми API: LM Studio, Ollama, vLLM, Together AI и другими.
+LLM-агент, который работает на маленьких моделях (Qwen3.5-9B, 32K-64K контекст). Пишет код, редактирует файлы, ищет баги, выполняет bash-команды, читает документацию — и всё это на моделях, которые запускаются на обычном ноутбуке без GPU.
+
+**Чем MMA отличается от больших агентов (OpenCode, Claude Code, Cursor):**
+
+- **Лёгкий**: не требует GPT-4 или Claude Sonnet. Работает на Qwen3.5-9B, DeepSeek-Coder и других opensource-моделях. Всё локально.
+- **ReAct-цикл**: модель сама планирует и вызывает инструменты через `<tool_call>` — читает/пишет/редактирует файлы, ищет по проекту, выполняет bash.
+- **Навыки (Skills)**: подгружаемые markdown-инструкции для специализированных задач (Docker, CSS, auth, и т.д.).
+- **Индексация кода**: AST-индекс символов + карта проекта (project map) для навигации по любой кодовой базе.
+- **Память**: долговременная память агента — запоминает факты между сессиями.
+- **Веб-поиск**: может искать информацию в интернете.
+- **Планирование**: создаёт и утверждает планы через PLAN.md перед выполнением.
+- **Сессии**: сохранение, восстановление, список сессий.
+- **MCP интеграция**: поддержка Model Context Protocol для внешних инструментов.
+- **Вопросы пользователю**: может уточнять детали задачи, запрашивать одобрение.
+- **Синтаксис @file**: загрузка файлов/директорий прямо в промпт.
+- **Стилизация**: сменные темы оформления.
+- **Мастер первого запуска**: интерактивная настройка провайдера и модели.
+- **12 файловых инструментов**: read, write, edit, list, create, delete, copy, move, info, glob, grep, tree.
+- **Простая установка**: `npm install -g micro-models-agent` и готово.
+
+Поддерживает OpenAI-совместимые API: LM Studio, Ollama, vLLM, Together AI и другие.
 
 ## Установка
 
@@ -36,55 +54,73 @@ rm -rf ~/.mma                          # удалить конфиг, кэш, л
 
 ## Быстрый старт
 
-### 1. Добавьте провайдера
-
-Если у вас уже запущен LM Studio на `localhost:1234`:
+### Интерактивный режим (REPL) — самый простой способ
 
 ```bash
-# Провайдер уже есть в конфиге по умолчанию, можно сразу использовать
-mma "Привет! Как тебя зовут?"
+# Установите
+npm install -g micro-models-agent
+
+# И просто запустите
+mma
 ```
 
-Если нужно добавить другого провайдера:
+> **Совет:** перед первым запуском запустите LM Studio → вкладка Local Server → Start Server → загрузите модель (например, [Qwen 3.5-9B](https://huggingface.co/Qwen/Qwen3.5-9B-Instruct-GGUF)). Мастер сам найдёт её и настроит.
 
-```bash
-# Ollama
-mma provider add ollama http://localhost:11434/v1
+**При первом запуске** появится мастер настройки:
+1. Выберите провайдера (LM Studio, Ollama или Remote API)
+2. Мастер найдёт доступные модели и протестирует соединение
+3. Готово — вы в REPL, можно писать запросы
+
+**При повторных запусках** REPL открывается сразу.
+
+В REPL работаете как в чате: пишете задачу, агент думает и выполняет. Доступны служебные команды:
+
+| Команда | Описание |
+|---------|----------|
+| `/help` | Справка |
+| `/read <file>` | Показать файл |
+| `/write <file>` | Записать файл |
+| `/bash <cmd>` | Выполнить команду |
+| `/clear` | Очистить контекст |
+| `/exit` | Выход |
 
-# vLLM
-mma provider add vllm http://localhost:8000/v1
+### One-shot (быстрый запрос)
 
-# Together AI
-mma provider add together https://api.together.xyz/v1
+```bash
+mma "Создай React-компонент для формы входа"
 ```
 
-### 2. Добавьте модель
+Можно передать провайдера и модель флагами:
 
 ```bash
-# mma model add <имя_алиас> <model_id> <контекст_в_токенах>
+mma --provider ollama --model qwen3.5-9b "Напиши Dockerfile"
+```
 
-mma model add qwen3.5-9b qwen3.5-9b-instruct 32768
-mma model add qwen2.5-14b qwen2.5-14b-instruct 32768
-mma model add deepseek-coder deepseek-coder-6.7b-instruct 16384
+### С пайпом (stdin)
+
+```bash
+cat package.json | mma "Опиши зависимости"
 ```
 
-### 3. Используйте
+## Настройка провайдеров и моделей
+
+По умолчанию конфиг настроен на LM Studio (`localhost:1234`). Если нужно добавить другой сервер:
 
 ```bash
-# One-shot режим
-mma "Создай React-компонент для формы входа"
+# Добавить провайдера
+mma provider add ollama http://localhost:11434/v1
 
-# Интерактивный режим (REPL)
-mma
+# Переключиться на него
+mma provider use ollama
 
-# С stdin (пайп)
-cat package.json | mma "Опиши зависимости"
+# Добавить модель к активному провайдеру
+mma model add qwen3.5-9b qwen3.5-9b-instruct 32768
 
-# С выбором провайдера/модели
-mma --provider ollama --model qwen3.5:9b "Напиши Dockerfile для Node.js приложения"
+# Выбрать модель (model add не активирует автоматически)
+mma model use qwen3.5-9b
 ```
 
-## Управление провайдерами и моделями
+### Все команды управления
 
 ```bash
 # Провайдеры
@@ -95,7 +131,8 @@ mma provider remove <имя>      # Удалить провайдера
 
 # Модели
 mma model list                 # Список моделей активного провайдера
-mma model use qwen3.5-9b       # Переключиться на модель
+mma model use <имя>            # Переключиться на модель
+mma model current              # Показать активную модель
 mma model add <имя> <id> <ctx> # Добавить модель
 mma model remove <имя>         # Удалить модель
 mma model params [имя]         # Параметры модели

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "micro-models-agent",
-  "version": "0.2.30",
+  "version": "0.2.32",
   "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
   "type": "module",
   "bin": {