Skip to main content

krypton-app

Bottom Line Up Front (BLUF) — Install krypton and every krypton interface on any platform:

  • Install krypton (the browser launcher) and vibey-engine in one command (macOS & Linux):
    curl -fsSL https://raw.githubusercontent.com/the-vibey-project/vibey/main/scripts/install.sh | sh -s -- --with-krypton
    # Or with uv / pipx / pip:
    uv tool install krypton-app   # or: pipx install krypton-app / pip install krypton-app
    
  • Launch it:
    krypton                       # starts `vibey serve` on 127.0.0.1:8765 and opens it in your browser
    vibey connect --yes           # plugs vibey into Claude Code, Claude Desktop, Codex, Cursor, VS Code & Gemini CLI
    
  • Install the other krypton apps:
    • krypton desktop (macOS 15+ Apple silicon): Download krypton-desktop-<version>-macos-arm64.dmg from GitHub Releases, drag krypton to Applications, and run xattr -dr com.apple.quarantine /Applications/krypton.app.
    • krypton desktop (Linux — any distro via Flatpak, or Ubuntu 24.04+ tarball): flatpak install --user krypton-desktop-<version>-linux-x86_64.flatpak (or sudo tar -xzf krypton-desktop-<version>-linux-x86_64.tar.gz -C /).
    • krypton for VS Code / VSCodium / Cursor: codium --install-extension the-vibey-project.krypton or code --install-extension krypton-vscode-<version>.vsix.
    • krypton web & mobile (Browser, Android .apk, iOS): See docs/guides/install.md and docs/guides/downloads.md.

krypton is every app and interface of vibey. This package carries them and installs one command, krypton.

pip install krypton-app      # brings vibey-engine[hub] with it: the engine and its web hub
krypton                      # start the local vibey hub and open it in your browser
krypton --help

What krypton does today

krypton is a launcher. It finds the vibey command, starts vibey serve on 127.0.0.1:8765 (change it with --host and --port), waits until the hub answers, and opens it in your browser, where the hub's front door says it is running and where to go next (the desktop app, the VS Code chat, or pairing a phone). --no-browser only starts it.

When the installed vibey-engine has no vibey serve yet, krypton says so plainly, lists what you can use instead, and exits with status 1. It never pretends a hub is running.

Releases

Published by .github/workflows/krypton-app.yml alone, by trusted publishing: a dev build to TestPyPI (environment testpypi) on each push to develop that changes this tree or the workflow, and a release to PyPI (environment pypi) on each such push to main. There is no schedule. A push GitHub skips publishes nothing: a squash merge whose message quotes an old [skip ci] subject skips every push workflow, which is how the 3.0.0 promotion first published neither package. Merge a promotion by rebase, or edit the squash message. ADR-0069 records why vibey publishes exactly two packages, vibey-engine and krypton-app.

Metadata

Release files for krypton-app 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for krypton-app 0.2.0
File Size Uploaded Provenance Actions
krypton_app-0.2.0.tar.gz 8.1 kB With provenance Details for krypton_app-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for krypton-app 0.2.0
File Interpreter ABI Platform Actions
krypton_app-0.2.0-py3-none-any.whl Python 3 none any Details for krypton_app-0.2.0-py3-none-any.whl

Total release size: 15.3 kB

Release files / krypton_app-0.2.0.tar.gz

Download URL krypton_app-0.2.0.tar.gz
Size 8.1 kB
Tags Source
SHA-256 checksum
How to use checksums
f1643adf465e3b677b1c6d857a527227c237d258c90aa6fa00f4f75055af47d9
BLAKE2b-256 checksum
How to use checksums
91a82869a3dd0ea77547dab0757199e40d43a6fde1ad50173ed6bfea1d40befb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.

Transparency log

Release files / krypton_app-0.2.0-py3-none-any.whl

Download URL krypton_app-0.2.0-py3-none-any.whl
Size 7.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7cf606da62dde7bc3acb22e3369653fba19ed59f24274240723456359a243db1
BLAKE2b-256 checksum
How to use checksums
38e5ff4dc4f1f6e2e88726a4d04054cc866d90323c50a71f7c49dd5895f8e724
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.

Transparency log

Security for krypton-app 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for krypton_app-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page