Metadata-Version: 2.4
Name: skaro
Version: 1.2.0
Summary: AI-powered SDLC orchestration platform
Project-URL: Homepage, https://github.com/skarodev/skaro
Project-URL: Repository, https://github.com/skarodev/skaro
Author: Skaro Contributors
License-Expression: AGPL-3.0-or-later
License-File: LICENSE
Keywords: ai,development,llm,methodology,specification
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Requires-Dist: anthropic>=0.40
Requires-Dist: click>=8.1
Requires-Dist: fastapi>=0.115
Requires-Dist: gitpython>=3.1
Requires-Dist: httpx>=0.27
Requires-Dist: jinja2>=3.1
Requires-Dist: mistune>=3.0
Requires-Dist: openai>=1.50
Requires-Dist: pyyaml>=6.0
Requires-Dist: questionary>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: uvicorn>=0.32
Requires-Dist: watchfiles>=0.24
Requires-Dist: websockets>=13.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

<div align="center">

# Skaro — AI-powered Software Development orchestration platform

<br />

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/skarodev/skaro/3e2cd385d4e49d4375ff14b7391903931652b62b/assets/logo-dark.svg" />
  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/skarodev/skaro/3e2cd385d4e49d4375ff14b7391903931652b62b/assets/logo-light.svg" />
  <img src="https://raw.githubusercontent.com/skarodev/skaro/3e2cd385d4e49d4375ff14b7391903931652b62b/assets/logo-dark.svg" alt="Skaro" width="200" />
</picture>

<br />
<br />

![PyPI - Version](https://img.shields.io/pypi/v/skaro?style=for-the-badge)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/skaro?style=for-the-badge)
![GitHub License](https://img.shields.io/github/license/skarodev/skaro?style=for-the-badge)

<br />

[Documentation](https://docs.skaro.dev) · [PyPI](https://pypi.org/project/skaro/) · [Telegram](https://t.me/skarodev) · [Discord](https://discord.gg/zUv6AHuJwD)

</div>

---

Developer is the architect, the AI is the executor.
<br />
Specifications live in the repository next to code. Context never gets lost.

## Install

Python 3.11+ required. Everything included: CLI, web dashboard, LLM adapters, templates.

**Linux / macOS:**

```sh
curl -fsSL https://raw.githubusercontent.com/skarodev/skaro/main/install.sh | sh
```

**Windows (PowerShell):**

```powershell
irm https://raw.githubusercontent.com/skarodev/skaro/main/install.ps1 | iex
```

**Alternative (if you have pipx or uv):**

```
pipx install skaro
# or
uv tool install skaro
```

## Quick start

```
cd my-project
skaro init
skaro ui
```

`skaro init` creates a `.skaro/` directory with constitution, architecture template, and config.

`skaro ui` starts the web dashboard at `http://localhost:4700`. LLM provider is configured from the UI.

## Update

Check for a new version:

```
skaro update
```

Use `--force` to bypass the 24-hour cache:

```
skaro update --force
```

**Upgrade — install script (venv):**

| OS | Command |
|---|---|
| Windows | `& "$env:USERPROFILE\.skaro\venv\Scripts\pip.exe" install --upgrade skaro` |
| macOS / Linux | `~/.skaro/venv/bin/pip install --upgrade skaro` |

Or simply re-run the install script — it detects the existing venv and upgrades in place.

**Upgrade — pipx:**

```
pipx upgrade skaro
```

Verify after upgrade:

```
skaro --version
```

## From source (development)

```
git clone https://github.com/skarodev/skaro.git
cd skaro
python3 -m venv .venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
```

Frontend (requires Node.js 18+):

```
cd frontend
npm install
npm run build
```

Run tests:

```
pytest
```

## License

AGPL-3.0 — see [LICENSE](LICENSE).

---

From Russia with love ❤️

