AI Setup PL

Konfiguracja AI

🌍 English · Polski · Français · Deutsch · 中文

ECLI dostarcza panel asystenta AI (Ctrl+A) integrujący się z czterema providerami. Żaden nie jest wymagany — ECLI działa w pełni bez AI.

Wspierani providerzy

Provider	Najlepsze dla	Model kosztów
Anthropic	Wysokiej jakości reasoning, długi kontekst, refaktoryzacja kodu	Pay-per-token, free trial
OpenAI	Szeroki ekosystem, rodzina GPT-4	Pay-per-token
Ollama	Offline / on-prem, bez kosztów API	Free (lokalne compute)
HuggingFace	Open-source models, eksperymenty	Free tier + płatne Inference API

Można skonfigurować wielu providerów i przełączać się klawiszem Tab w panelu AI.

---

Anthropic (Claude)

Najlepszy balans jakości i kosztu dla pracy z kodem.

1. Pobierz API key

• Załóż konto na console.anthropic.com
• Wygeneruj key w "API Keys"
• Klucze zaczynają się od sk-ant-...

2. Skonfiguruj ECLI

Dodaj do ~/.config/ecli/config.toml:

[ai]
default_provider = "anthropic"

[ai.anthropic]
api_key = "sk-ant-..."          # lub użyj zmiennej ANTHROPIC_API_KEY
model = "claude-sonnet-4-5"     # lub claude-opus-4-5, claude-haiku-4-5
max_tokens = 4096
temperature = 0.2
timeout_seconds = 60

3. Lub przez zmienne środowiskowe

export ANTHROPIC_API_KEY="sk-ant-..."
export ECLI_AI_PROVIDER="anthropic"

Env vars mają pierwszeństwo nad configiem — przydatne na shared machines.

Wybór modelu

• claude-haiku-4-5 — szybki, tani, dobry do krótkich edycji i szybkich pytań
• claude-sonnet-4-5 — zbalansowany, rekomendowany domyślny
• claude-opus-4-5 — najsilniejszy, wolniejszy i droższy

---

OpenAI

1. Pobierz API key

• Załóż konto na platform.openai.com
• Dodaj billing (wymagany dla dostępu API)
• Wygeneruj key w "API keys"
• Klucze zaczynają się od sk-proj-... lub sk-...

2. Skonfiguruj ECLI

[ai]
default_provider = "openai"

[ai.openai]
api_key = "sk-..."              # lub zmienna OPENAI_API_KEY
model = "gpt-4o"                # lub gpt-4o-mini, gpt-4-turbo, o1
max_tokens = 4096
temperature = 0.2
timeout_seconds = 60

3. Lub przez zmienne środowiskowe

export OPENAI_API_KEY="sk-..."
export ECLI_AI_PROVIDER="openai"

Wybór modelu

• gpt-4o-mini — szybki i tani
• gpt-4o — rekomendowany domyślny
• o1 / o1-mini — modele reasoning, wolniejsze ale lepsze na skomplikowanych problemach

---

Ollama (lokalnie)

Uruchom modele AI lokalnie — bez API key, bez chmury, bez kosztów.

1. Zainstaluj Ollama

# Linux / macOS
curl -fsSL https://ollama.com/install.sh | sh

# Lub przez package manager
brew install ollama       # macOS

Uruchom daemon:

ollama serve              # działa na localhost:11434

2. Pobierz model

ollama pull llama3.1:8b
ollama pull codellama:13b
ollama pull qwen2.5-coder:7b   # tuned pod kod

3. Skonfiguruj ECLI

[ai]
default_provider = "ollama"

[ai.ollama]
endpoint = "http://localhost:11434"
model = "qwen2.5-coder:7b"
timeout_seconds = 120          # modele lokalne mogą być wolniejsze

Uwagi sprzętowe

• Modele 7B-8B — działają na laptopie z 16GB RAM
• Modele 13B — potrzebują ~16GB RAM, szybsze z GPU
• Modele 70B — potrzebują dedykowanego GPU (24GB+ VRAM)

---

HuggingFace Inference

1. Pobierz token

• Załóż konto na huggingface.co
• Stwórz access token w Settings → Access Tokens
• Tokeny zaczynają się od hf_...

2. Skonfiguruj ECLI

[ai]
default_provider = "huggingface"

[ai.huggingface]
api_key = "hf_..."             # lub zmienna HF_TOKEN
model = "meta-llama/Meta-Llama-3.1-8B-Instruct"
endpoint = "https://api-inference.huggingface.co"
timeout_seconds = 120

Free tier

Darmowe Inference API ma rate limits i może mieć cold-start delays. Dla produkcji przejdź na Inference Endpoints (płatne, dedykowana pojemność).

---

Przełączanie providerów runtime

W panelu AI naciśnij Tab aby przełączać między wszystkimi providerami skonfigurowanymi w config.toml. Bieżący provider pokazany jest w nagłówku panelu.

Można też nadpisać per launch:

ECLI_AI_PROVIDER=ollama ecli

---

Wyłączanie AI

[ai]
default_provider = "none"

Panel Ctrl+A nadal się otworzy ale wyświetli komunikat zamiast przyjmować input. Aby całkowicie usunąć keybinding, patrz Skróty › Personalizacja.

---

Prywatność

• Anthropic / OpenAI / HuggingFace — Twoje prompty (i kod który załączasz) są wysyłane do serwerów providera zgodnie z ich polityką prywatności.
• Ollama — działa całkowicie lokalnie. Żadne dane nie opuszczają Twojej maszyny.

Jeśli pracujesz z wrażliwym kodem lub proprietary IP, użyj Ollama lub wyłącz AI całkowicie.

Monitoring kosztów

Anthropic i OpenAI dostarczają dashboardy zużycia w swoich konsolach. ECLI nie wyświetla obecnie szacunków kosztów wewnątrz edytora (planowane w v0.2).

Rozwiązywanie problemów z AI

Objaw	Prawdopodobna przyczyna	Naprawa
"API key not configured"	Brak klucza w configu i env	Ustaw api_key w configu lub eksportuj env var
"Connection refused" (Ollama)	Daemon nie działa	ollama serve
"Rate limit exceeded"	Zbyt wiele requestów	Poczekaj lub zmień providera
"Context length exceeded"	Prompt za długi	Zmniejsz input lub użyj modelu z większym kontekstem
Wolne odpowiedzi	Latencja providera lub rozmiar modelu lokalnego	Zmień model, sprawdź sieć

Więcej: Rozwiązywanie problemów › AI.