Anything World API wrapper library and CLI
Project description
Anything World Python Client
Python library and CLI for Anything World API.
Installing
pip install anythingworld
Using
First of all, edit the provided env.example
file with the right API key and rename
it to .env
.
From Python
from anythingworld import AWClient
# Create a client to be able to query Anything World's API
client = AWClient()
# Upload files from ./examples/cat folder to be animated
response = await client.animate('./examples/cat', 'some_cat', 'cat', is_symmetric=True)
# Response has the model_id of the 3D model that our AI pipeline is currently animating
model_id = response["model_id"]
# Runs a long-polling loop, starting it only after 2 minutes and after that,
# checking every 5 secs if the API is done animating the model
animated_response = await client.get_animated_model(model_id, waiting_time=5, warmup_time=120)
# Check if our AI pipeline is done animating the model
is_finished = await client.is_animation_done(model_id)
assert is_finished == True
From CLI
All AWClient
methods are exposed as commands of the anything
CLI tool.
Just call the anything
tool and it will display a manual page of the
available commands:
anything
You can do exactly the same we did in Python before through the CLI:
anything animate ./examples/cat "some cat" "cat" --is_symmetric
anything get_animated_model <MODEL_ID>
Developing
Installing from source
git clone git@github.com:anythingworld/anything-world-python.git
cd anything-world-python
python3 -m venv venv
source venv/bin/activate
pip install -e .
Testing
pytest -v -s
Releasing a new pip package
Bump the version in pyproject.toml
and then:
python -m build
twine upload dist/anything-world-<x.y.z>.tar.gz
License
This Python module has a MIT-style license, as found in the LICENSE file.
The cat model in examples/cat
folder is from Google Poly (CC-BY 4.0) license.
The ASCII logo was generated by https://patorjk.com/software/taag/ using the original font fuzzy.flf by Juan Car (jc@juguete.quim.ucm.es).
Project details
Release history Release notifications | RSS feed
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
Hashes for anything_world-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dd38d4a223b43a3fb5e1b4ed69c88865ca3a646c53f1c92404bc863a05852fba |
|
MD5 | 09ead7e25db47abe42b3c47adeb0a23b |
|
BLAKE2b-256 | f9643eabdc782f6962f1715dbaf3f406835d9a7e4ea67181fe0d79a2542e9517 |