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.2.0 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. Supported native targets are macOS arm64/x86_64, Linux glibc 2.28+ arm64/x86_64, and Windows arm64/x86_64. Every supported wheel contains its target Moli sidecar and provenance record. Linux musl is intentionally omitted because upstream Moli publishes no musl asset; use a system/explicit browser or another backend there. The loader still falls back to exact per-minor names when reading older release manifests.

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). The extracted Moli executable is placed in the same version/target cache and is selected through A3S_CODE_MOLI_EXECUTABLE; atomic extraction and the bootstrap's cross-process installer lock make concurrent first imports single-flight. Rust, Node.js, and Go use the Core-managed Moli cache when they are not using a package-local sidecar.

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 and arm64 (glibc 2.28+)
  • Windows x86_64 and arm64

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)
A3S_CODE_MOLI_EXECUTABLE Explicit verified Moli executable; skips package discovery
A3S_CODE_MOLI_CACHE_DIR Core-managed shared Moli cache root (the bootstrap uses its version/target cache for a bundled sidecar)
A3S_CODE_MOLI_RELEASE_BASE_URL HTTPS mirror for the pinned Moli release

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.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (8.5.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for linzhixiao from gravatar.com linzhixiao

Credits

Author: A3S Lab

License

MIT License (MIT)

Requires

Python >=3.10

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

a3s_code-8.2.0.tar.gz (15.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

a3s_code-8.2.0-py3-none-any.whl (10.4 kB view details)

Uploaded Python 3

File details

Details for the file a3s_code-8.2.0.tar.gz.

File metadata

  • Download URL: a3s_code-8.2.0.tar.gz
  • Upload date:
  • Size: 15.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.14

File hashes

Hashes for a3s_code-8.2.0.tar.gz
Algorithm Hash digest
SHA256 d2656378f2ffc0fd7d3ee66b0fdbbc19930b6904e2dc18f682da68d1f6098dcc
MD5 275c2c32edcf2671bd9d61928c5b59c5
BLAKE2b-256 c68256125c679d61fdcdd93c5fd0890a4436da51fe730c20cd51bf94da15c1fb

See more details on using hashes here.

File details

Details for the file a3s_code-8.2.0-py3-none-any.whl.

File metadata

  • Download URL: a3s_code-8.2.0-py3-none-any.whl
  • Upload date:
  • Size: 10.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.14

File hashes

Hashes for a3s_code-8.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 66c90f3a22d06ff74ad6349690eb6bf3c74df87b2f2d58aac353460b7a157a2e
MD5 020c32623d7bda028579173c14c80937
BLAKE2b-256 f1f179acfe8109cf12666d27ee81d500410d4ac2b7bd1914b294da9fb43ec5e1

See more details on using hashes here.

Release history Release notifications | RSS feed

8.5.1

2 files

8.4.0

2 files

8.3.0

2 files

This release

8.2.0 This release

2 files

8.1.0

2 files

8.0.4

2 files

8.0.3

2 files

8.0.2

2 files

8.0.1

2 files

8.0.0

2 files

7.0.2

2 files

7.0.1

2 files

6.9.0

2 files

6.8.1

2 files

6.8.0

2 files

6.7.0

2 files

6.6.0

2 files

6.5.2

2 files

6.5.1

2 files

6.5.0

2 files

6.4.3

2 files

6.4.2

2 files

6.4.1

2 files

6.4.0

2 files

6.3.1

2 files

6.3.0

2 files

6.2.0

2 files

6.1.0

2 files

6.0.0

2 files

5.3.5

2 files

5.3.4

2 files

5.3.3

2 files

5.3.2

2 files

5.3.1

2 files

5.3.0

2 files

5.2.8

2 files

5.2.7

2 files

5.2.4

2 files

5.2.3

2 files

5.2.2

2 files

5.1.0

2 files

5.0.0

2 files

4.3.3

2 files

4.2.8

2 files

4.2.7

2 files

4.2.6

2 files

4.2.5

2 files

4.2.4

2 files

4.2.3

2 files

4.2.2

2 files

4.2.1

2 files

4.1.0

2 files

4.0.0

2 files

3.6.2

2 files

3.5.0

2 files

3.4.0

2 files

3.3.0

2 files

3.2.1

2 files

Yanked

3.2.0

1 file

3.1.0

12 files

3.0.0

12 files

2.6.0

12 files

2.5.0

13 files

2.4.0

12 files

2.3.0

12 files

2.2.0

12 files

2.1.0

12 files

2.0.1

12 files

2.0.0

12 files

1.11.0

2 files

1.10.0

2 files

1.9.4

2 files

1.9.3

2 files

1.9.2

2 files

1.9.1

2 files

1.9.0

2 files

1.8.6

2 files

1.8.5

2 files

1.8.4

2 files

1.8.3

2 files

1.8.0

2 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