a3s-code (Python bootstrap)
pip install a3s-code ships this small pure-Python package. On first
import a3s_code it downloads the native extension matching your
platform from the project's
GitHub Releases, verifies
the wheel's sha256 against the release manifest, extracts the compiled
extension into a per-user cache, and exposes the normal a3s_code API.
The v8.0.3 release uses one CPython 3.10 stable-ABI (cp310-abi3) wheel per
platform. That wheel is installable by CPython 3.10, 3.11, 3.12, 3.13, and
3.14. The published v8.0.2 assets predate this workflow and still use exact
CPython 3.10–3.13 wheel names; upgrade the bootstrap to v8.0.3 for Python
3.14. The loader falls back to the exact per-minor names used by older
releases, so upgrading the bootstrap does not invalidate an older release
asset.
Subsequent imports use the cached extension. Cache lives under a
platform-specific directory, ~/.cache/a3s-code/<version>/<platform-tag>/
(or $A3S_CODE_CACHE_DIR/<version>/<platform-tag>/ when overridden).
Why
PyPI imposes a default 10 GB per-project storage cap. A Rust SDK with
~17 MB native wheels per Python × platform tripped that limit. GitHub
Releases is the canonical wheel host; this bootstrap keeps
pip install a3s-code working without dragging the native wheels back
through PyPI.
Supported platforms
- macOS arm64 (Apple Silicon, macOS 11+)
- macOS x86_64 (Intel, macOS 12+)
- Linux x86_64 (glibc 2.28+)
- Windows x86_64
CPython 3.10, 3.11, 3.12, 3.13, and 3.14.
The bootstrap itself needs a working pip in the interpreter that runs it. If
python3.14 -m pip reports No module named pip, initialize pip and retry:
python3.14 -m ensurepip --upgrade
python3.14 -m pip install --upgrade pip
python3.14 -m pip install a3s-code
Environment overrides
| Variable | Effect |
|---|---|
A3S_CODE_CACHE_DIR |
Cache root (defaults to $XDG_CACHE_HOME/a3s-code or ~/.cache/a3s-code) |
A3S_CODE_RELEASES_BASE_URL |
Override the release base URL — useful for air-gapped mirrors |
A3S_CODE_SKIP_HASH_CHECK |
1 skips sha256 verification (do not use in production) |
Manual install
If you do not want the bootstrap to phone home, install the native wheel directly:
pip install \
'https://github.com/A3S-Lab/Code/releases/download/v<VERSION>/a3s_code-<VERSION>-cp310-abi3-manylinux_2_28_x86_64.whl'
For an Intel Mac on macOS 12 or later, use the macosx_12_0_x86_64 asset:
pip install \
'https://github.com/A3S-Lab/Code/releases/download/v<VERSION>/a3s_code-<VERSION>-cp310-abi3-macosx_12_0_x86_64.whl'
Replace <VERSION> with the release to install. The Intel asset is available
from the first release produced with the Intel build matrix.
The Intel macOS 12 build does not ship the optional local ONNX embedding adapter. Keep retrieval model-free or configure an explicitly authorized remote embedding provider when using that platform.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file a3s_code-8.0.3.tar.gz.
File metadata
- Download URL: a3s_code-8.0.3.tar.gz
- Upload date:
- Size: 11.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8ac1d67ea8b7d837f6bea501b63de277054b5cde43a864610bf1099e1f20424c
|
|
| MD5 |
aeff8b320fcac81f2a4da17f1a989c9f
|
|
| BLAKE2b-256 |
25fee8cbffa72cd1b5fa466b98696354af5d897e589dfae5585390fdd42e16fb
|
File details
Details for the file a3s_code-8.0.3-py3-none-any.whl.
File metadata
- Download URL: a3s_code-8.0.3-py3-none-any.whl
- Upload date:
- Size: 7.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
25d6b32ee05ae2395f57c0fe7d7e8058bbafcb68c3c7c14d75fb9a8aa2722134
|
|
| MD5 |
9cec98d93f9063de7bcdc6f6f1029c35
|
|
| BLAKE2b-256 |
6be8657384fca12c873892fa5c59bc3a1eaa48a7107f361da90c63cd48cf7414
|
