Metadata-Version: 2.4
Name: mico-agent
Version: 0.1.0
Summary: mico — local coding agent for Apple Silicon (MLX) and Linux
Author: mico contributors
License: Apache-2.0
Project-URL: Homepage, https://github.com/captainonedin/mico
Project-URL: Repository, https://github.com/captainonedin/mico
Project-URL: Issues, https://github.com/captainonedin/mico/issues
Keywords: llm,agent,cli,mlx,coding-assistant,local-ai
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: requests>=2.31
Requires-Dist: prompt_toolkit>=3.0.43
Requires-Dist: rich>=13.7
Requires-Dist: tomli>=2.0; python_version < "3.11"
Provides-Extra: mlx
Requires-Dist: mlx>=0.20; extra == "mlx"
Requires-Dist: mlx-lm>=0.21; extra == "mlx"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Dynamic: license-file

# mico ⚓

> Local coding agent for Apple Silicon and Linux. Runs your model. On your machine. End-to-end.

```
                          ⚓
                       ┌──────┐
                       │ mico │
                       └──────┘
```

**Status:** alpha (0.1.0). API ve CLI değişebilir.

## Ne işe yarar?

mico, terminalinden çalışan, **yerel LLM**'lerle (MLX / Ollama / OpenAI uyumlu sunucular) konuşan bir coding agent'tır:

- Yapısal araç çağrıları (`read_file`, `replace_in_file`, `bash`, `run_tests`, `grep_code`, ...)
- Otomatik patch + test loop
- Oturum kalıcılığı, kompakt geçmiş özetleme
- Donanıma göre profil önerisi
- Bedava, açık kaynak, telemetry yok

## Gereksinimler

- macOS (Apple Silicon önerilir) veya Linux
- Python 3.11+
- 16 GB+ unified memory (8B model için 8 GB yeter, 14B+ için 24 GB+)

## Hızlı kurulum

```bash
pip install mico-agent            # core
pip install 'mico-agent[mlx]'     # Apple Silicon MLX backend ile
mico                        # ilk çalıştırma → wizard
```

İlk açılışta mico:

1. Donanımı tespit eder (CPU, RAM, GPU/Neural Engine)
2. `~/Desktop/models/`, HF cache, LM Studio'yu tarayıp yerel modelleri listeler
3. Donanım × model eşleşmesinden bir profil önerir, onaylatır
4. Tüm tercihleri `~/.mico/` altına kaydeder, bir daha sormaz

## Komutlar

```
mico                    Interaktif chat
mico ask "prompt"       Tek seferlik
mico setup              Wizard'ı tekrar çalıştır (--force ile zorla)
mico models             Algılanan modelleri listele
mico --doctor           Tanı çıktısı (donanım + profil)
mico server-stop        Çalışan model sunucusunu durdur
```

## TUI özellikleri

- **Slash komut paleti**: `/` yazınca komutlar dropdown ile gelir
  - `/help` `/mode` `/network` `/thinking` `/cd` `/compact` `/clear`
  - `/history` `/save` `/model` `/exit`
- **Dosya tamamlama**: `@` yazınca cwd'deki dosyalar autocomplete
- **Alt çubuk**: Aktif model · mode · ctx · network · thinking durumu canlı
- **JSON-aware streaming**: Model'in `{"type":"final","message":"..."}` ham
  JSON'u kullanıcıya gizlenir; sadece temiz mesaj görünür
- **Tool çağrı render'ı**: `▸ tool_name(args)` + foldlanmış sonuç
- **Spinner**: Braille animasyonu (TTY) — `düşünüyor → yazıyor` geçişi
- **Sıkı kapatma**: Ctrl+D'de model server'a SIGTERM → 3sn → SIGKILL
- **Oturum sürdürme**: Aynı session'a kaldığı yerden devam veya yeniden başla
- **Trivial chat fast path**: `selam` gibi sohbetler tool loop'u atlar

## İlk kurulum

```bash
git clone https://github.com/captainonedin/mico ~/mico
~/mico/bin/mico                  # ilk açılış → wizard
# veya PATH'e ekle:
ln -s ~/mico/bin/mico /opt/homebrew/bin/mico   # macOS
ln -s ~/mico/bin/mico ~/.local/bin/mico        # Linux
```

İlk açılışta:
1. Sistem Python 3.11+ tespit edilir
2. Bağımlılıklar listelenir + onay alınır
3. Mevcut bir venv'de gerekli paketler varsa yeniden indirilmez
4. Yoksa `~/.mico/.venv` oluşturulup oraya kurulur (PEP 668 uyumlu)
5. mico kendini venv'den yeniden başlatır

## Mimari

Detay: `docs/architecture.md`.

## Güvenlik araçları

mico **çekirdek olarak** sadece coding/dev iş akışına odaklı. Pentest/security tooling
ayrı bir paket olarak yayınlanır:

```bash
pip install mico-security   # nmap, ffuf, openssl wrappers; auditing skills
```

mico-security ayrı repodadır, ayrı izinlerle yönetilir, default'ta yüklü değildir.

## Lisans

Apache-2.0 — bkz. [LICENSE](LICENSE) ve [NOTICE](NOTICE).

## Katkı

[CONTRIBUTING.md](CONTRIBUTING.md) — issue açmadan önce oku.
