PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

0.2.0

PyPI

achilles-optimizer

Claude-Powered Python Performance Optimizer

Published3 May 2025
Direct dependencies7
Transitive dependenciesNot calculated

README

Version 0.2.0 documentation

                 Achilles Logo   

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:

  1. Set the ANTHROPIC_API_KEY environment variable
  2. Create a .env file 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

CommandDescription
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.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 7

Native requirements
7 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
anthropic
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.13",
  "evaluation": "NOT_EVALUATED"
}
anthropic>=0.50.0runtime
build
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.13",
  "evaluation": "NOT_EVALUATED"
}
build>=1.2.2.post1runtime
dotenv
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.13",
  "evaluation": "NOT_EVALUATED"
}
dotenv>=0.9.9runtime
pybind11
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.13",
  "evaluation": "NOT_EVALUATED"
}
pybind11>=2.13.6runtime
rich
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.13",
  "evaluation": "NOT_EVALUATED"
}
rich>=14.0.0runtime
setuptools
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.13",
  "evaluation": "NOT_EVALUATED"
}
setuptools>=79.0.1runtime
twine
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.13",
  "evaluation": "NOT_EVALUATED"
}
twine>=6.1.0runtime

Distribution files

2 collected
achilles_optimizer-0.2.0-py3-none-any.whl

bdist_wheel · 24.29 KB · Python py3

Source file
achilles_optimizer-0.2.0.tar.gz

sdist · 21.49 KB · Python source

Source file

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 18:12 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:dc18696d2003e1ea7f705a86f487fc412e3d2aea07aaea0351c8fd705a3a977d

Other collected versions

View all collected versions →