Skip to content

release: publish v2.0.3 one-line installer #157

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
EvanProgramming merged 1 commit into from
Sep 14, 2026
Merged

release: publish v2.0.3 one-line installer #157

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions README.ja.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -90,16 +90,16 @@ OpenKyrozen はターミナルで動作する**自己学習型 AI エージェ
macOS または Linux：

```bash
curl -fsSL https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.2/install.sh | sh
curl -fsSL https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.3/install.sh | sh
```

Windows PowerShell：

```powershell
irm https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.2/install.ps1 | iex
irm https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.3/install.ps1 | iex
```

インストーラーは不変の GitHub `v2.0.2` リリース wheel を取得し、OS、アーキテクチャ、Python、ネットワーク、ユーザーパスの書き込み可否を確認します。必要なら `uv` を導入し、分離された `uv` ツール環境に Web 依存関係を用意して、プライベートな `~/.kyrozen` 状態ディレクトリを作成し、`kyrozen --version` と `kyrozen --help` を検証します。API キーを読み取り、表示、アップロードすることはありません。初回の `kyrozen` 起動でプロバイダー設定を案内します。
インストーラーは不変の GitHub `v2.0.3` リリース wheel を取得し、OS、アーキテクチャ、Python、ネットワーク、ユーザーパスの書き込み可否を確認します。必要なら `uv` を導入し、分離された `uv` ツール環境に Web 依存関係を用意して、プライベートな `~/.kyrozen` 状態ディレクトリを作成し、`kyrozen --version` と `kyrozen --help` を検証します。API キーを読み取り、表示、アップロードすることはありません。初回の `kyrozen` 起動でプロバイダー設定を案内します。

### 開発専用のソースチェックアウト

Expand All @@ -123,14 +123,14 @@ run.bat
### 固定 GitHub リリースからのインストール

```bash
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl'
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl'
uv tool install --python 3.12 --force --with fastapi --with uvicorn "$release_url"

# 対応済みの Python 環境ではこちらも使用できます：
pip install fastapi uvicorn "$release_url"
```

v2.0.2 のリリース wheel は GitHub Actions でビルド・検証済みです。詳しくは [v2.0.2 リリース](https://github.com/EvanProgramming/OpenKyrozen/releases/tag/v2.0.2) を参照してください。インストール後は任意の呼び出し元ディレクトリから `kyrozen` と `kyrozen-web` を実行できます。暗号化されたプロバイダー設定は `~/.kyrozen_config.json` に保存されます。
v2.0.3 のリリース wheel は GitHub Actions でビルド・検証済みです。詳しくは [v2.0.3 リリース](https://github.com/EvanProgramming/OpenKyrozen/releases/tag/v2.0.3) を参照してください。インストール後は任意の呼び出し元ディレクトリから `kyrozen` と `kyrozen-web` を実行できます。暗号化されたプロバイダー設定は `~/.kyrozen_config.json` に保存されます。

---

Expand Down Expand Up @@ -171,7 +171,7 @@ Kyrozen は：
| `/api_key` | API キーを変更 |
| `/learn` | プロジェクトファイルを即座にメモリにスキャン |
| `/forget` | 最近の学習を表示；`/forget キーワード` で誤った学習を削除 |
| `/update` | 固定された GitHub `v2.0.2` リリース wheel を再インストール（プロジェクトへ git pull しない） |
| `/update` | 固定された GitHub `v2.0.3` リリース wheel を再インストール（プロジェクトへ git pull しない） |
| `/self-learning` | 個別の自己学習機能をオン/オフ |

### Web UI モード
Expand Down Expand Up @@ -444,7 +444,7 @@ curl -sS -X DELETE http://127.0.0.1:8000/api/v2/memory/claims/<claim_id>
## 🌐 Web UI と REST API

```bash
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl'
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl'
pip install fastapi uvicorn "$release_url"
kyrozen-web --port 8000
# http://localhost:8000 を開く
Expand Down Expand Up @@ -665,7 +665,7 @@ GitHub Actions がプッシュと PR ごとに自動実行：
- Windows PowerShell インストーラーの構文とヘルプ経路のチェック
- Docker ビルドとコンテナ置換後の復元スモークテスト

公開済みの `v2.0.2` リリースは不変であり、公開インストーラーと `/update` は
公開済みの `v2.0.3` リリースは不変であり、公開インストーラーと `/update` は
このリリースに固定されています。将来のリリースは意図的な手動作業として、
固定バージョンを更新し、成果物と両方のインストーラーを検証してから新しい
タグを公開してください。
Expand All @@ -674,7 +674,7 @@ GitHub Actions がプッシュと PR ごとに自動実行：

```bash
# 不変の GitHub リリース（インストーラーが uv と Python の設定も行います）
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl'
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl'
uv tool install --python 3.12 --force --with fastapi --with uvicorn "$release_url"
pip install fastapi uvicorn "$release_url"

Expand Down
18 changes: 9 additions & 9 deletions README.ko.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -90,16 +90,16 @@ OpenKyrozen은 터미널에서 실행되는 **자기 학습형 AI 에이전트**
macOS 또는 Linux:

```bash
curl -fsSL https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.2/install.sh | sh
curl -fsSL https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.3/install.sh | sh
```

Windows PowerShell:

```powershell
irm https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.2/install.ps1 | iex
irm https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.3/install.ps1 | iex
```

설치 프로그램은 변경할 수 없는 GitHub `v2.0.2` 릴리스 wheel을 가져와 OS, 아키텍처, Python, 네트워크와 사용자 경로 쓰기 권한을 확인합니다. 필요하면 `uv`를 설치하고, 격리된 `uv` 도구 환경에 Web 의존성을 준비하며, 비공개 `~/.kyrozen` 상태 디렉터리를 만든 뒤 `kyrozen --version`과 `kyrozen --help`를 검증합니다. API 키를 읽거나 출력하거나 업로드하지 않으며, 첫 `kyrozen` 실행에서 제공자 설정을 안내합니다.
설치 프로그램은 변경할 수 없는 GitHub `v2.0.3` 릴리스 wheel을 가져와 OS, 아키텍처, Python, 네트워크와 사용자 경로 쓰기 권한을 확인합니다. 필요하면 `uv`를 설치하고, 격리된 `uv` 도구 환경에 Web 의존성을 준비하며, 비공개 `~/.kyrozen` 상태 디렉터리를 만든 뒤 `kyrozen --version`과 `kyrozen --help`를 검증합니다. API 키를 읽거나 출력하거나 업로드하지 않으며, 첫 `kyrozen` 실행에서 제공자 설정을 안내합니다.

### 개발 전용 소스 체크아웃

Expand All @@ -123,14 +123,14 @@ run.bat
### 고정된 GitHub 릴리스 설치

```bash
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl'
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl'
uv tool install --python 3.12 --force --with fastapi --with uvicorn "$release_url"

# 이미 지원되는 Python 환경에서는 다음도 사용할 수 있습니다:
pip install fastapi uvicorn "$release_url"
```

v2.0.2 릴리스 wheel은 GitHub Actions에서 빌드하고 검증했습니다. 자세한 내용은 [v2.0.2 릴리스](https://github.com/EvanProgramming/OpenKyrozen/releases/tag/v2.0.2)를 참조하세요. 설치 후에는 어떤 호출 디렉터리에서도 `kyrozen`과 `kyrozen-web`을 실행할 수 있습니다. 암호화된 제공자 설정은 `~/.kyrozen_config.json`에 저장됩니다.
v2.0.3 릴리스 wheel은 GitHub Actions에서 빌드하고 검증했습니다. 자세한 내용은 [v2.0.3 릴리스](https://github.com/EvanProgramming/OpenKyrozen/releases/tag/v2.0.3)를 참조하세요. 설치 후에는 어떤 호출 디렉터리에서도 `kyrozen`과 `kyrozen-web`을 실행할 수 있습니다. 암호화된 제공자 설정은 `~/.kyrozen_config.json`에 저장됩니다.

---

Expand Down Expand Up @@ -171,7 +171,7 @@ Kyrozen의 동작:
| `/api_key` | API 키 변경 |
| `/learn` | 프로젝트 파일을 즉시 메모리에 스캔 |
| `/forget` | 최근 학습 확인; `/forget 키워드`로 잘못된 학습 삭제 |
| `/update` | 고정된 GitHub `v2.0.2` 릴리스 wheel을 다시 설치 (프로젝트에 git pull을 실행하지 않음) |
| `/update` | 고정된 GitHub `v2.0.3` 릴리스 wheel을 다시 설치 (프로젝트에 git pull을 실행하지 않음) |
| `/self-learning` | 개별 자기 학습 기능 켜기/끄기 |

### Web UI 모드
Expand Down Expand Up @@ -443,7 +443,7 @@ curl -sS -X DELETE http://127.0.0.1:8000/api/v2/memory/claims/<claim_id>
## 🌐 Web UI 및 REST API

```bash
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl'
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl'
pip install fastapi uvicorn "$release_url"
kyrozen-web --port 8000
# http://localhost:8000 열기
Expand Down Expand Up @@ -663,15 +663,15 @@ GitHub Actions가 모든 푸시와 PR에서 자동 실행:
- Windows PowerShell 설치 프로그램 구문 및 도움말 경로 확인
- Docker 빌드 및 컨테이너 교체 복구 스모크 테스트

게시된 `v2.0.2` 릴리스는 변경할 수 없으며 공개 설치 프로그램과 `/update`는 이
게시된 `v2.0.3` 릴리스는 변경할 수 없으며 공개 설치 프로그램과 `/update`는 이
릴리스에 고정됩니다. 향후 릴리스는 의도적인 수동 작업으로 진행합니다. 고정 버전을
업데이트하고, 아티팩트와 두 설치 프로그램을 검증한 뒤 새 태그를 게시하세요.

### 릴리스 wheel

```bash
# 변경할 수 없는 GitHub 릴리스 (설치 프로그램이 uv와 Python 설정도 처리합니다)
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl'
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl'
uv tool install --python 3.12 --force --with fastapi --with uvicorn "$release_url"
pip install fastapi uvicorn "$release_url"

Expand Down
20 changes: 10 additions & 10 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,16 +91,16 @@ Think of it as an AI teammate that gets smarter every time you use it.
On macOS or Linux:

```bash
curl -fsSL https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.2/install.sh | sh
curl -fsSL https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.3/install.sh | sh
```

On Windows PowerShell:

```powershell
irm https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.2/install.ps1 | iex
irm https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.3/install.ps1 | iex
```

The installer fetches the immutable `v2.0.2` GitHub release wheel, checks the operating system, architecture, Python, network, and writable user paths; installs `uv` when needed; provisions the Web dependencies in an isolated `uv` tool environment; creates private `~/.kyrozen` state directories; and verifies `kyrozen --version` and `kyrozen --help`. It never reads, prints, or uploads API keys. The first `kyrozen` launch guides provider setup.
The installer fetches the immutable `v2.0.3` GitHub release wheel, checks the operating system, architecture, Python, network, and writable user paths; installs `uv` when needed; provisions the Web dependencies in an isolated `uv` tool environment; retries once with `uv --no-cache` if an incomplete local cache is encountered; creates private `~/.kyrozen` state directories; and verifies `kyrozen --version` and `kyrozen --help`. It never reads, prints, or uploads API keys. The first `kyrozen` launch guides provider setup.

### Development-only source checkout

Expand All @@ -124,14 +124,14 @@ These commands intentionally run in project mode (`--project .`) and are for rep
### Pinned GitHub release installation

```bash
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl'
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl'
uv tool install --python 3.12 --force --with fastapi --with uvicorn "$release_url"

# Or use pip in an existing supported environment:
pip install fastapi uvicorn "$release_url"
```

The v2.0.2 release wheel was built and validated by GitHub Actions; see the [v2.0.2 release](https://github.com/EvanProgramming/OpenKyrozen/releases/tag/v2.0.2). After installation, `kyrozen` and `kyrozen-web` work from any caller directory. The encrypted provider configuration is saved to `~/.kyrozen_config.json`.
The v2.0.3 release wheel was built and validated by GitHub Actions; see the [v2.0.3 release](https://github.com/EvanProgramming/OpenKyrozen/releases/tag/v2.0.3). After installation, `kyrozen` and `kyrozen-web` work from any caller directory. The encrypted provider configuration is saved to `~/.kyrozen_config.json`.

---

Expand Down Expand Up @@ -172,7 +172,7 @@ Kyrozen will:
| `/api_key` | Change your API key |
| `/learn` | Immediately scan project files into memory |
| `/forget` | Show recent learnings; `/forget keyword` to delete bad learnings |
| `/update` | Reinstall the pinned `v2.0.2` GitHub release wheel (never pulls into a project) |
| `/update` | Reinstall the pinned `v2.0.3` GitHub release wheel (never pulls into a project) |
| `/agent auto\|coder\|researcher` | Choose automatic routing or an isolated learning profile |
| `/learning status [profile]` | Show candidate, canary, active, retired, and rolled-back artifacts |
| `/learning metrics [profile]` | Show verified completion, corrections, errors, cost, and latency metrics |
Expand Down Expand Up @@ -596,7 +596,7 @@ with the same provider, model, configuration, and observable product behavior.
## 🌐 Web UI & REST API

```bash
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl'
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl'
pip install fastapi uvicorn "$release_url"
kyrozen-web --port 8000
# Open http://localhost:8000
Expand Down Expand Up @@ -659,7 +659,7 @@ KYROZEN_SERVER_TOKEN=change-me kyrozen-web --host 0.0.0.0 --port 8000

Browser tools (`browser_open`, `browser_snapshot`, `browser_click`, `browser_type`, and
`browser_close`) use an isolated profile and are available after
`pip install playwright https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl && playwright install chromium`. Private and
`pip install playwright https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl && playwright install chromium`. Private and
loopback destinations are blocked unless `KYROZEN_BROWSER_ALLOW_PRIVATE=1` is set.

Successful `POST /api/chat` requests emit one `chat.completed` webhook after
Expand Down Expand Up @@ -924,7 +924,7 @@ GitHub Actions automatically runs on every push and PR:
- Windows PowerShell installer syntax/help check
- Docker build and replace-container recovery smoke test

The published `v2.0.2` release is immutable and remains the pinned target for
The published `v2.0.3` release is immutable and remains the pinned target for
public installers and `/update`. A future release is a deliberate, manual
release operation: update the pinned version, build and validate the artifacts,
and verify both installers before publishing the new tag.
Expand All @@ -933,7 +933,7 @@ and verify both installers before publishing the new tag.

```bash
# Immutable GitHub release (use the one-line installer for uv + Python setup)
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.2/openkyrozen-2.0.2-py3-none-any.whl'
release_url='https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.3/openkyrozen-2.0.3-py3-none-any.whl'
uv tool install --python 3.12 --force --with fastapi --with uvicorn "$release_url"
pip install fastapi uvicorn "$release_url" # existing supported environment

Expand Down
Loading
Loading