SDK Overview
Aholo provides official SDKs in three languages. They wrap authentication, multipart upload, task polling, and other details so you can integrate without hand-writing HTTP.
- GitHub: manycoretech/aholo-spatial-sdk
Capability matrix
| Capability | TypeScript | Java | Python |
|---|---|---|---|
| Asset upload | Yes | Yes | Yes |
| World | Yes | Yes | Yes |
| Lux3D | Yes | Yes | Yes |
| RenderCloud | — | — | — |
RenderCloud has no SDK wrapper yet. See the RenderCloud sections in API Reference.
Versions: Lux3D SDK is at v1.7.0 for TypeScript, Java, and Python. It adds multimodal-to-image, prompt-capable four-view, and STL/3MF export. Generation versions are
G1/G1-Turbo. World is v1.3.0; Asset and core remain v1.2.0. MCP is@manycore/aholo-sdk-mcp@1.7.0.
Quick install
- TypeScript
- Java
- Python
# Install only the packages you need
npm install @manycore/aholo-sdk-asset
npm install @manycore/aholo-sdk-world
npm install @manycore/aholo-sdk-lux3d
<!-- pom.xml — add as needed -->
<dependency>
<groupId>com.manycoreapis</groupId>
<artifactId>aholo-sdk-asset</artifactId>
<version>1.2.0</version>
</dependency>
<dependency>
<groupId>com.manycoreapis</groupId>
<artifactId>aholo-sdk-world</artifactId>
<version>1.3.0</version>
</dependency>
<dependency>
<groupId>com.manycoreapis</groupId>
<artifactId>aholo-sdk-lux3d</artifactId>
<version>1.7.0</version>
</dependency>
# Install only the packages you need
pip install manycore-aholo-sdk-asset
pip install manycore-aholo-sdk-world
pip install manycore-aholo-sdk-lux3d
Packages
TypeScript / Node.js
Requirements: Node.js ≥ 18
| Package | npm |
|---|---|
@manycore/aholo-sdk-asset |  |
@manycore/aholo-sdk-world |  |
@manycore/aholo-sdk-lux3d |  |
@manycore/aholo-sdk-core |  |
Java
Requirements: Java 8+, Maven ≥ 3.6 (JDK 17 or 21 recommended when building from source)
| Artifact | Maven Central |
|---|---|
com.manycoreapis:aholo-sdk-asset | View |
com.manycoreapis:aholo-sdk-world | View |
com.manycoreapis:aholo-sdk-lux3d | View |
com.manycoreapis:aholo-sdk-core | View |
Python
Requirements: Python ≥ 3.9
| Package | PyPI |
|---|---|
manycore-aholo-sdk-asset |  |
manycore-aholo-sdk-world |  |
manycore-aholo-sdk-lux3d |  |
manycore-aholo-sdk-core |  |
Authentication
All SDKs read your API key as follows:
Recommended: environment variable (SDK reads AHOLO_API_KEY automatically)
export AHOLO_API_KEY=your_api_key_here
You can also pass the key explicitly in code — see each language guide below.
Never hardcode API keys in source code, packages, or public repositories.
Apply for an API key: Global · China
Region
| Value | Description | API endpoint |
|---|---|---|
cn | China | https://api.aholo3d.cn |
com | Global | https://api.aholo3d.com |
Async tasks & status
World and Lux3D are async: after creation, poll until a terminal state. Each SDK provides waitFor / tasks.waitFor helpers.
World task status
| Phase | Status | Description |
|---|---|---|
| In progress | PENDING | Queued |
| In progress | PREPROCESSING | Preprocessing |
| In progress | RUNNING | Running |
| Success | SUCCEEDED | Done — read assets.splats.urls (incl. lodMetaPath), assets.imagery.panoUrl (generation), assets.semanticsMetadata.upAxis |
| Failed | FAILED | Failed |
| Failed | CANCELED | Canceled |
| Failed | TIMEOUT | Timed out |
| Failed | REJECTED | Rejected |
waitFor(worldId) returns details on SUCCEEDED; failure terminal states throw PollingFailedError (Java: AholoException).
Lux3D task status
| Value | Description |
|---|---|
0 | Initializing |
1 | Running |
3 | Success (outputs[n].content is a download URL, valid ~2 hours) |
4 | Failed |
6 | Canceled |
Image/text generation supports zip / glb / ply; material transfer supports zip / glb / usdz / obj zip / fbx zip; multi-format export supports usdz / obj zip / fbx zip / stl / 3mf.
tasks.waitFor(taskId) returns when status === 3; throws on status === 4 or 6.
Language guides
GitHub README is for installation only. If it conflicts with this page, this page wins. Source and runnable examples: GitHub.