Metadata-Version: 2.4
Name: iskra
Version: 0.3.0
Summary: Iskra - agent AI do kodowania w terminalu (Python)
Author-email: Iskra <kontakt@iskra.app>
License-Expression: MIT
Project-URL: Homepage, https://iskra.app
Project-URL: Documentation, https://iskra.app/docs
Project-URL: Upstream, https://github.com/GPT-AGI/Clawd-Codex
Keywords: ai,cli,agent,llm,anthropic,openai,glm,coding-assistant
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: anthropic
Requires-Dist: cryptography>=42.0.0
Requires-Dist: openai
Requires-Dist: python-dotenv
Requires-Dist: rich
Requires-Dist: prompt-toolkit
Requires-Dist: tiktoken>=0.7.0
Requires-Dist: zhipuai
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Requires-Dist: pytest>=8.0.0; extra == "dev"
Dynamic: license-file

# Iskra

**Agent AI do kodowania w Twoim terminalu.** Iskra rozumie projekt, czyta i pisze pliki, uruchamia
komendy i prowadzi Cię przez zadanie krok po kroku — bez wychodzenia z konsoli.

- 🔑 **Działa na Twoim kluczu AI** — Ty wybierasz dostawcę (Anthropic / OpenAI / GLM) i płacisz
  tylko za to, czego naprawdę użyjesz. My nie doliczamy nic za tokeny.
- 💻 **Linux, macOS i Windows** — instalacja jedną komendą, bez uprawnień administratora.
- 🔌 **Twoje modele, Twoje dane** — klucz API zostaje na Twoim komputerze w `~/.iskra/config.json`.
- 🧩 **Umiejętności (`SKILL.md`)** — rozszerzasz asystenta własnymi procedurami.

---

## Wymagania

| | |
|---|---|
| Python | **3.10 lub nowszy** |
| System | Linux, macOS, Windows |
| Klucz API | własne konto u dostawcy AI (Anthropic / OpenAI / Zhipu GLM) |
| Licencja | aktywna subskrypcja Iskra |

## Instalacja

**Linux / macOS**

```bash
curl -fsSL https://iskra.app/pobierz/install.sh | bash
```

**Windows (PowerShell)**

```powershell
irm https://iskra.app/pobierz/install.ps1 | iex
```

Instalator tworzy izolowane środowisko w `~/.iskra` (Windows: `%USERPROFILE%\.iskra`), dodaje
komendę `iskra` i **nie rusza systemowego Pythona**.

## Pierwsze uruchomienie

```bash
iskra buy                       # kup subskrypcję — otworzy stronę płatności
                                # klucz przyjdzie e-mailem
iskra activate ISKRA-XXXXX-XXXXX-XXXXX-XXXXX
iskra login                     # wklej własny klucz API dostawcy AI
iskra                           # start
```

Zakup ręczny (bez serwera płatności): wyślij sprzedawcy identyfikator komputera
(`iskra fingerprint`), a otrzymany token aktywuj tak samo —
`iskra activate <TOKEN>`.

Stan licencji sprawdzisz w każdej chwili:

```bash
iskra license
```

Przenosisz się na inny komputer? Na starym uruchom `iskra deactivate`, na nowym
`iskra activate` z tym samym kluczem.

## Plany

| Plan | Cena | Urządzenia |
|---|---|---|
| **Solo** | 49 zł / mies. | 1 |
| **Pro** | 99 zł / mies. | 3 |
| **Team** | 249 zł / mies. | 10 |

Ceny brutto. Subskrypcję możesz anulować w każdej chwili — licencja działa do końca opłaconego okresu.

## Co potrafi

- **Rozmowa w terminalu** — historia, uzupełnianie klawiszem Tab, tryb wielolinijkowy.
- **Praca na plikach** — czytanie, wyszukiwanie i edycja kodu w Twoim projekcie.
- **Uruchamianie komend** — z pytaniem o zgodę przy operacjach, które coś zmieniają.
- **Pętla agenta** — asystent sam wybiera narzędzia i wraca z wynikiem, zamiast tylko odpowiadać.
- **Kontekst projektu** — wczytuje `CLAUDE.md` i pliki projektu, żeby rozumieć konwencje.
- **Umiejętności** — własne procedury w `SKILL.md`, projektowe (`.iskra/skills/`) lub globalne
  (`~/.iskra/skills/`). Odczytujemy też umiejętności Claude Code z `.claude/skills/`.
- **Komendy w sesji** — `/help`, `/clear`, `/save`, `/load`, `/multiline`, `/stream`.

> Iskra jest w fazie intensywnego rozwoju — część zaawansowanych funkcji (m.in. kompresja długich
> rozmów i diagnostyka `/doctor`) jest jeszcze w planach. Kupując subskrypcję, wspierasz ich rozwój
> i dostajesz aktualizacje bez dopłat.

## Prywatność

- Klucz API i licencja leżą lokalnie: `~/.iskra/config.json` i `~/.iskra/license.json`.
- Serwer licencji jest odpytywany tylko po to, żeby potwierdzić ważność subskrypcji — przesyła
  **identyfikator urządzenia** (skrót z danych systemowych, nie zawiera Twoich plików).
- Bez internetu program działa dalej przez **7 dni**, potem licencja wymaga ponownej weryfikacji.
- Kod Twojego projektu nie jest nigdzie wysyłany poza wybranego przez Ciebie dostawcę AI.

## Licencja

Iskra jest udostępniana na **licencji MIT**. Projekt powstał na bazie otwartoźródłowego
`GPT-AGI/Clawd-Codex` — oryginalna nota o prawach autorskich i tekst licencji są zachowane
w pliku [`LICENSE`](LICENSE), a oryginalna dokumentacja w [`ATTRIBUTION.md`](ATTRIBUTION.md).

---

## English (short)

**Iskra** is an AI coding agent for your terminal (Linux/macOS/Windows, Python 3.10+).
It runs on **your own** AI provider key — you only pay your provider for what you use.

```bash
curl -fsSL https://iskra.app/pobierz/install.sh | bash   # Linux / macOS
```

Then `iskra buy` → `iskra activate ISKRA-…` → `iskra login` → `iskra`.

Plans: Solo 49 PLN / Pro 99 PLN / Team 249 PLN per month (1 / 3 / 10 devices).
Licensed under MIT; upstream attribution in `LICENSE` and `ATTRIBUTION.md`.
