mico-agent 0.1.0

mico — local coding agent for Apple Silicon (MLX) and Linux

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

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

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:

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 ve NOTICE.

Katkı

CONTRIBUTING.md — issue açmadan önce oku.