Skip to main content

GhostMode

The Air-Gapped, Self-Healing Code Repair Agent for Low-Resource Hardware.

GhostMode runs a trusted test command, identifies a likely application frame, asks a local Ollama model for a function replacement, applies it with a backup, and retains it only after the tests pass. It never contacts a network target other than loopback Ollama.

Supported languages

GhostMode supports Python, JavaScript, TypeScript, React (.jsx/.tsx), PHP/Laravel, and Rust. React, Vite, Next.js, Angular, Laravel, and Cargo projects are verified through the test or build command you provide. Python receives AST syntax validation; other languages use conservative structural validation before their own local test/build tools provide final verification.

Install and run

pip install ghostmode-cli
ollama pull qwen2.5-coder:1.5b
ghostmode doctor

Run GhostMode from the project you want to repair:

ghostmode run "pytest -q"

For npm projects:

ghostmode run "npm test"

Use --dry-run to review a diff without changing files. GhostMode never edits tests unless --allow-test-edits is explicitly passed. For Vitest projects, ghostmode run "npm test" automatically uses single-run mode instead of watch mode.

Memory budget

Component Budget
GhostMode Python process under 100 MB RSS
Ollama + 0.5B model about 1 GB
Ollama + 1.5B model about 2 GB

Limitations

Small local models are best at simple, single-function faults. Multi-file, API-wide, and logic-heavy repairs often need human review. Only run trusted test commands: the command is intentionally executed through a shell to support normal test invocations.

Metadata

Release files for ghostmode-cli 0.1.1

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

Source distribution (sdist)

Source distribution for ghostmode-cli 0.1.1
File Size Uploaded
ghostmode_cli-0.1.1.tar.gz 14.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ghostmode-cli 0.1.1
File Interpreter ABI Platform
ghostmode_cli-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 29.3 kB

Release files / ghostmode_cli-0.1.1.tar.gz

Download URL ghostmode_cli-0.1.1.tar.gz
Size 14.9 kB
Tags Source
SHA-256 checksum
How to use checksums
67762330dcd2e74bd95e9c50ea5b10f31ad1441faa732fa437d77351c04c71a0
BLAKE2b-256 checksum
How to use checksums
24063186602a0bafd8fc478d0c9e75816c0d65aff8d1a94c68fdecb154c4983f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 9, 2026.

Transparency log

Release files / ghostmode_cli-0.1.1-py3-none-any.whl

Download URL ghostmode_cli-0.1.1-py3-none-any.whl
Size 14.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7a8d2ad6ddb6ad6d2002674992ce01b8c1749eff6eb92c36d8d0174cc9fc34c7
BLAKE2b-256 checksum
How to use checksums
e8122c0fe4870e303f5572e915fd80d418c5f8a0ba9eb357dccd727d3be01a3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 9, 2026.

Transparency log

Release history Release notifications | RSS feed

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

This release

0.1.1 This release

2 release files

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