anchorai-sdk
Official Python client and local web chat UI for Anchor AI (Fathom-1) —
Anchor Cloud's self-hosted assistant. Uses the same ac_live_... API key as
the anchorcloud library, since both
authenticate against the same account on anchorcloud.org.
Install
pip install anchorai-sdk
Chat UI (recommended)
Launches a polished local web chat interface in your browser — nothing runs
except on your own machine, and the only outbound calls are to
anchorcloud.org using your API key.
anchorai --api-key ac_live_...
# or: set ANCHORCLOUD_API_KEY in your environment, then just: anchorai
Opens http://127.0.0.1:8420 automatically. Options:
anchorai --api-key ac_live_... --port 9000 --no-browser
Library usage
from anchorai import AnchorAI
client = AnchorAI(api_key="ac_live_...")
reply = client.ask("Organize my vault into folders by file type")
print(reply)
for m in client.history():
print(m["role"], ":", m["message"])
client.send(message) returns the full response dict from the server
({"reply": ..., "type": ...}, occasionally including a files list for
download requests); client.ask(message) is a shortcut that just returns the
reply text.
Getting an API key
Same key as the anchorcloud library: dashboard.anchorcloud.org → API
Keys → Generate New Key. One key works for both file storage and chat,
since they share the same account and auth.
Error handling
from anchorai import AnchorAI, AuthError, ApiError
try:
client = AnchorAI(api_key="ac_live_...")
client.ask("hello")
except AuthError:
print("Key is missing, malformed, or was revoked.")
except ApiError as e:
print(f"Server error ({e.status_code}): {e}")
Requirements
- Python 3.9+
requests
License
MIT — see LICENSE.
Metadata
Release files for anchorai-sdk 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| anchorai_sdk-0.1.1.tar.gz | 10.3 kB | Without provenance | Details for anchorai_sdk-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| anchorai_sdk-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for anchorai_sdk-0.1.1-py3-none-any.whl |
Total release size: 20.9 kB
Release files / anchorai_sdk-0.1.1.tar.gz
| Download URL | anchorai_sdk-0.1.1.tar.gz |
|---|---|
| Size | 10.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e62124bc552499652343a3b7009b14aca6f73025152941ba1ee265de05abc66c
|
|
BLAKE2b-256 checksum How to use checksums |
78f54bfb6d8c45fc9706906591db350533b7a3fe7825194a826bd3139bc12678
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / anchorai_sdk-0.1.1-py3-none-any.whl
| Download URL | anchorai_sdk-0.1.1-py3-none-any.whl |
|---|---|
| Size | 10.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
906ad068852a80a34b989a9677ff4beb97b5d496e5363f466cf17f30211649c5
|
|
BLAKE2b-256 checksum How to use checksums |
360f45d7939592002d3bbdd7561e6ccdb9a26ced6620b4c354620a7842524dba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for anchorai-sdk 0.1.1
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.