This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
GhostAI Connect
GhostAI Connect links an inference server you run yourself (Ollama, vLLM, or any OpenAI-compatible server) to GhostAI. It opens one outbound WebSocket connection to the GhostAI relay, so you never open an inbound firewall port.
Install
Python 3.10 or later:
pipx install ghostai-connect # or: pip install ghostai-connect
ghostai-connect --version
Or use the container image for linux/amd64 and linux/arm64:
ghcr.io/dymium-io/ghostai-connect:<version>.
Verify before you run it
The container image is signed keyless with Sigstore by this repository's
release workflow. With cosign
v2 or later:
cosign verify \
--certificate-identity-regexp '^https://github\.com/dymium-io/ghostai-connect/\.github/workflows/publish-image\.yml@refs/tags/v' \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
ghcr.io/dymium-io/ghostai-connect:<version>
The PyPI files carry PEP 740 attestations
from the same repository. With pipx install pypi-attestations:
pypi-attestations verify pypi \
--repository https://github.com/dymium-io/ghostai-connect \
pypi:ghostai_connect-<version>-py3-none-any.whl
RELEASE_SIGNING.md in the source repository has the details.
Enroll and run
Use the enrollment command shown in the GhostAI admin console. The token is single-use.
ghostai-connect enroll <token> \
--base-url https://your-ghostai-instance.example.com \
--relay-url wss://relay-connector.your-ghostai-instance.example.com/connector/ws
ghostai-connect run # runs until stopped; reconnects automatically
ghostai-connect doctor # last heartbeat, registration status, last error
The enrolled credential is stored in ~/.config/ghostai-connect/config.json
with mode 0600.
| Environment variable | Meaning | Default |
|---|---|---|
GHOSTAI_CONNECT_LOCAL_URL |
Your local inference server | http://localhost:11434 |
GHOSTAI_CONNECT_MAX_CONCURRENCY |
Concurrent requests forwarded to it | 4 |
GHOSTAI_CONNECT_MAX_RECONNECT_ATTEMPTS |
Give up after this many consecutive failed reconnects | retry forever |
In a container
The image runs ghostai-connect run. Enroll once into a volume, then mount
that volume when you start the connector:
docker run --rm -v ghostai-connect:/home/connect/.config/ghostai-connect \
ghcr.io/dymium-io/ghostai-connect:<version> \
enroll <token> --base-url ... --relay-url ...
docker run -d --name ghostai-connect \
-v ghostai-connect:/home/connect/.config/ghostai-connect \
-e GHOSTAI_CONNECT_LOCAL_URL=http://ollama:11434 \
ghcr.io/dymium-io/ghostai-connect:<version>
Upgrade
pipx upgrade ghostai-connect # or: pip install --upgrade ghostai-connect
Your enrollment is kept. Restart ghostai-connect run after upgrading.
License
Proprietary. Copyright (c) 2026 Dymium, Inc. All rights reserved. Use requires an active GhostAI subscription, under your agreement with Dymium, Inc.; see the LICENSE file included with the package. Questions: support@dymium.io.
1 maintainer
Metadata
1 maintainer
Release files for ghostai-connect 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ghostai_connect-0.2.2.tar.gz | 50.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ghostai_connect-0.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 107.0 kB
Release files / ghostai_connect-0.2.2.tar.gz
| Download URL | ghostai_connect-0.2.2.tar.gz |
|---|---|
| Size | 50.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7b5034544f83fd5625f3e662f2f64f0a853b21fe92d3508247c972e0b73ca7cc
|
|
BLAKE2b-256 checksum How to use checksums |
59402333df9f2a7a3a4bb0c41de982076cea576931180550b9a47ce6c3b4240e
|
| 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 11, 2026.
Transparency logRelease files / ghostai_connect-0.2.2-py3-none-any.whl
| Download URL | ghostai_connect-0.2.2-py3-none-any.whl |
|---|---|
| Size | 56.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d24186b01cda824bb4e5f1db9567caa40c257559f39ddce1e14dac05c1064593
|
|
BLAKE2b-256 checksum How to use checksums |
e733b2e2b79867bfe12b2cd14f50ac3863486b20d2af3e496e444c115582d977
|
| 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 11, 2026.
Transparency log
