This is a python module that provides a set of tools for working with machine learning models. It includes utilities for neural architecture search using optuna, builders and helpers for keras/tensorflow, a monitoring system for the kernel, and several other features. The module is designed to be easy to use and flexible, allowing users to customize their machine learning workflows.
Table of Contents
- Table of Contents
- 📚 API Documentation
- ⚙️ Installation Instructions
- 🐧 Linux GPU Venv Setup (TensorFlow + Torch)
- 🚀 Release Flow
- 🔖 Versioning Policy
- 🤝 Contributing
- 📜 License
- 🤝 Collaborators
📚 API Documentation
For comprehensive documentation, examples, and detailed usage guides, please visit our Documentation Wiki.
⚙️ Installation Instructions
Install only the feature set you need:
pip install araras
pip install araras[tensorflow]
pip install araras[torch]
pip install araras[viz]
pip install araras[notebook]
pip install araras[gnn]
pip install araras[all]
Notes:
- The base install is lightweight and excludes heavyweight ML backends.
- TensorFlow support is enabled via the tensorflow extra.
- PyTorch support is enabled via the torch extra.
- Visualization and notebook extras are optional and independent.
🐧 Linux GPU Venv Setup (TensorFlow + Torch)
For Linux users with an NVIDIA GPU, this repository includes an installer script at venvs/tf-gpu.sh that creates and configures a virtual environment with:
- TensorFlow (
tensorflow[and-cuda]) - PyTorch (
torch,torchinfo,torchviz) - Optuna and common ML/data-science utilities
araras[all]
The script also verifies CPU and GPU TensorFlow availability at the end.
Run it from the repository root:
chmod +x venvs/tf-gpu.sh
./venvs/tf-gpu.sh
Important notes:
- Linux only (script uses
aptandnvidia-smi). - You will be prompted for the virtual environment name and location.
- A supported NVIDIA driver is required (the script checks this automatically).
- The script uses
python3.12by default.
🚀 Release Flow
Maintainer quick path:
python -m build
twine check dist/*
git tag v1.0.0
git push origin v1.0.0
Tag pushes matching v* trigger the publish workflow.
🔖 Versioning Policy
- The value in pyproject.toml project.version must match the Git tag version.
- Release order: bump version, merge to main, tag as v, push tag.
- PyPI versions are immutable and cannot be re-used.
🤝 Contributing
Contributions are what make the open-source community amazing. To contribute:
- Fork the project.
- Create a feature branch (
git checkout -b feature/new-feature). - Commit your changes (
git commit -m 'Add some feature'). - Push to the branch (
git push origin feature/new-feature). - Open a Pull Request.
📜 License
This project is licensed under the General Public License.
🤝 Collaborators
We thank the following people who contributed to this project:
 Matheus Ferreira |
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 araras-2.8.0.tar.gz.
File metadata
- Download URL: araras-2.8.0.tar.gz
- Upload date:
- Size: 248.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1da559c63992908cfd6eb68d64fb1f8613f0bac5eb84bc153970f03b1464b184
|
|
| MD5 |
175ff4fbaa5f1a150f8b5b37fc1e92cc
|
|
| BLAKE2b-256 |
c374135a97f75ab172b66aea5a700d57bea5e64d6f14dedbf6440185c44ca7cf
|
Provenance
The following attestation bundles were made for araras-2.8.0.tar.gz:
Publisher:
publish.yml on MatheusFS-dev/araras
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
araras-2.8.0.tar.gz -
Subject digest:
1da559c63992908cfd6eb68d64fb1f8613f0bac5eb84bc153970f03b1464b184 - Sigstore transparency entry: 2549524760
- Sigstore integration time:
-
Permalink:
MatheusFS-dev/araras@0621c837899b5eef0e4091812404e985029a93f8 -
Branch / Tag:
refs/tags/v2.8.0 - Owner: https://github.com/MatheusFS-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@0621c837899b5eef0e4091812404e985029a93f8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file araras-2.8.0-py3-none-any.whl.
File metadata
- Download URL: araras-2.8.0-py3-none-any.whl
- Upload date:
- Size: 284.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
de2064ed1341e50ec39ccedc8376a41183c871e505d4753cf33196ebf943bc64
|
|
| MD5 |
2c8d5c1e05ec7fe9002d5a14b4b86027
|
|
| BLAKE2b-256 |
510bc3ce49f8a7c67b1315afc64a3dd94b283c046ae4c3b83b2b31e12e38f7cb
|
Provenance
The following attestation bundles were made for araras-2.8.0-py3-none-any.whl:
Publisher:
publish.yml on MatheusFS-dev/araras
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
araras-2.8.0-py3-none-any.whl -
Subject digest:
de2064ed1341e50ec39ccedc8376a41183c871e505d4753cf33196ebf943bc64 - Sigstore transparency entry: 2549524786
- Sigstore integration time:
-
Permalink:
MatheusFS-dev/araras@0621c837899b5eef0e4091812404e985029a93f8 -
Branch / Tag:
refs/tags/v2.8.0 - Owner: https://github.com/MatheusFS-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@0621c837899b5eef0e4091812404e985029a93f8 -
Trigger Event:
push
-
Statement type:
