Metadata-Version: 2.4
Name: matish-ai
Version: 2.0.0
Summary: MATISH AI — ИИ-помощник в терминале: чаты с паролем и шифрованием, память, агент с файлами и Word, поиск в интернете, консилиум моделей
Author: Даниил Неструев
License-Expression: MIT
Keywords: ai,cli,chat,openrouter,terminal,assistant,llm
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: Russian
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25
Requires-Dist: rich>=12.0
Requires-Dist: pyfiglet>=0.8
Dynamic: license-file

# MATISH AI

ИИ-помощник прямо в терминале. Работает на Windows, Linux (в том числе МОС) и macOS.

```
    __  ______  _______________ __  __   ___    ____
   /  |/  /   |/_  __/  _/ ___// / / /  /   |  /  _/
  / /|_/ / /| | / /  / / \__ \/ /_/ /  / /| |  / /
 / /  / / ___ |/ / _/ / ___/ / __  /  / ___ |_/ /
/_/  /_/_/  |_/_/ /___//____/_/ /_/  /_/  |_/___/
```

## Что умеет

- 💬 **Чаты с историей**: сколько угодно чатов, их можно открывать, переименовывать и удалять.
- 🧠 **Память**: Матиш сам запоминает важное о тебе («запомни, что я люблю пиццу») и помнит это во всех чатах.
- 🔒 **Пароль и шифрование**: ключи API, чаты и память шифруются твоим паролем. Без него их никто не прочитает.
- 🔎 **Поиск в интернете**: находит свежие факты и читает страницы, в ответе даёт ссылки на источники.
- 📎 **Агент с файлами**: читает и правит файлы, создаёт документы **Word (.docx)**, смотрит картинки. Каждую запись на диск ты подтверждаешь сам.
- 🤝 **Консилиум**: над вопросом параллельно думают несколько моделей, а основная собирает лучший ответ.
- ☁ **Синхронизация через GitHub Gist**: продолжай разговор на другом компьютере. В Gist данные лежат зашифрованными.
- ✨ Анимации и ответы, которые печатаются по мере генерации.

## Установка

```bash
pip install --user matish-ai
```

Запуск:

```bash
matish
```

Если команда `matish` не находится, запускай так: `python3 -m matish` (на Windows — `python -m matish`).

### Без прав администратора (школьные компьютеры, МОС)

`--user` ставит пакет только для тебя, `sudo` не нужен. Если система ругается на
`externally-managed-environment`, поставь Матиша в своё окружение:

```bash
python3 -m venv ~/matish-env
~/matish-env/bin/pip install matish-ai
~/matish-env/bin/matish
```

Нужен Python 3.8 или новее. Все остальные зависимости (`requests`, `rich`, `pyfiglet`) ставятся сами.

## Первый запуск

Мастер настройки попросит:

1. Имя.
2. Пароль. **Запомни его**: восстановить нельзя, можно только сбросить всё командой `matish --reset`.
3. Ключ [OpenRouter](https://openrouter.ai/keys). Бесплатные модели работают даже с нулевым балансом.
4. Модель. По умолчанию бесплатная `cohere/north-mini-code:free`.
5. По желанию — токен GitHub для синхронизации. Нужно только одно право: **Gists → Read and write**.

## Команды

| Команда | Что делает |
|---|---|
| `help` | все команды |
| `/new`, `/chats`, `/open N` | новый чат, список чатов, открыть чат |
| `/memory`, `/forget N` | что Матиш помнит, забыть факт |
| `/attach путь` | прикрепить картинку или файл к следующему сообщению |
| `/files` | рабочая папка агента (`~/Matish`) |
| `/model free` | выбрать бесплатную модель |
| `/models` | избранные модели |
| `/council on` | включить консилиум |
| `/tools off` | запретить файлы и поиск в интернете |
| `/password` | сменить пароль |
| `clear`, `exit` | очистить экран, выйти |

## Приватность

- Сообщения уходят к модели через OpenRouter, у каждой модели свои правила обработки данных.
  Бесплатные модели часто используют запросы для улучшения, так что **не отправляй им личное**.
- Пароль нигде не хранится, хранится только его проверочный «отпечаток».
- Файлы на компьютере:
  - `~/.matish_config.json` — настройки, ключи зашифрованы;
  - `~/.matish_data.enc` — зашифрованные чаты и память;
  - `~/Matish/` — рабочая папка агента.

## Лицензия

MIT. Автор — Даниил Неструев.
