Achilles: LLM-powered Python performance optimizer
How to use Achilles
Install Achilles using the following command:
uv add achilles-optimizer
Once Achilles is installed, you can optimize a python executable using the following command:
uv run achilles optimize your_python_file.py --your_python_args
If you've already ran Achilles once, you can benchmark it against the non-optimized python code with the following command:
uv run achilles benchmark your_python_file.py --your_python_args
To run a python executable using achillles, just type the following command:
uv run achilles run your_python_file.py --your_python_args
Additional Information
Requirements
- Python 3.13 or later
- uv package manager
- An Anthropic API key (Claude)
Environment Setup
You can set up your Anthropic API key in one of two ways:
- Set the
ANTHROPIC_API_KEYenvironment variable - Create a
.envfile in your project directory with the following content:ANTHROPIC_API_KEY=your_api_key_here
How It Works
Achilles uses Claude to analyze your Python code and optimize its performance by:
- Identifying bottlenecks through profiling
- Implementing optimizations automatically in C++
- Importing these optimizations at runtime
Command Reference
| Command | Description |
|---|---|
uv run achilles optimize <file.py> |
Analyzes and optimizes your Python file |
uv run achilles benchmark <file.py> |
Compares optimized vs. original performance |
uv run achilles run <file.py> |
Runs your Python file with Achilles |
Contributing
Contributions are welcome! Feel free to submit issues or pull requests on GitHub.
License
This project is open source. See the repository for license details.
Metadata
Release files for achilles-optimizer 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| achilles_optimizer-0.2.0.tar.gz | 22.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| achilles_optimizer-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 46.9 kB
Release files / achilles_optimizer-0.2.0.tar.gz
| Download URL | achilles_optimizer-0.2.0.tar.gz |
|---|---|
| Size | 22.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
076612039945b8bbf13c20f6850c9cf18986a558c881c4f2d878a2c4c6987f57
|
|
BLAKE2b-256 checksum How to use checksums |
1cc05d7fe8049fdb5404b113e3759348b50a3cea646d5edcf04e20f930153906
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.0
|
Release files / achilles_optimizer-0.2.0-py3-none-any.whl
| Download URL | achilles_optimizer-0.2.0-py3-none-any.whl |
|---|---|
| Size | 24.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0dba7701b1a1e51170987f2ca342afb819ff5ef4f70ecd18e5c166cf14f09930
|
|
BLAKE2b-256 checksum How to use checksums |
17a43e2f5648187f1c84ed21c17bafcc54f5378fadc0183b0d8037864c109586
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.0
|
Security for achilles-optimizer 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
