codeflash-ai/codeflash
1
0
Fork 0
Code Issues 18 Pull requests 33 Projects Releases Packages Wiki Activity Actions 1.7k
Coding super-intelligence to find the most optimized Python code. Use it to optimize existing codebases or new Pull requests as a GitHub Action or a VS Code Extension.
6181 commits 508 branches 66 tags 118 MiB
Find a file
Kevin Turcios 18ad00be59 chore: improve skills to 100% review score and bump to v0.2.0 
- Add trigger hints and code snippets to both skills
- Add checkpoints after each step
- Extract module reference and troubleshooting into linked files
- Bump codeflash-skills tile to 0.2.0
2026-02-14 21:07:24 -05:00
.claude docs: add new-branch-from-main rule to git guidelines 2026-02-14 18:28:15 -05:00
.github/workflows chore: replace gh-aw duplicate detector with claude-code-action + Serena 2026-02-14 19:05:47 -05:00
code_to_optimize fixes for unit tests 2026-02-12 19:30:46 +02:00
codeflash fix: normalize jest mock paths with pathlib for Windows compat 2026-02-13 10:10:50 -05:00
codeflash-benchmark cond addopts 2025-08-24 01:59:48 -05:00
docs Merge branch 'main' into jit-docs 2026-01-29 12:06:54 -08:00
experiments fix: lint issues in experiments folder and format fixes 2026-01-29 19:26:50 +05:30
packages/codeflash Merge branch 'main' of github.com:codeflash-ai/codeflash into fix/js-jest30-loop-runner 2026-02-12 16:39:33 +02:00
tests fix: import jest patterns from source module instead of re-export 2026-02-13 09:55:14 -05:00
tiles chore: improve skills to 100% review score and bump to v0.2.0 2026-02-14 21:07:24 -05:00
.gitignore feat: add modular Claude Code rules in .claude/rules/ 2026-02-06 02:12:27 -05:00
.mcp.json Add MCP config for .mcp.json 2026-02-15 00:20:41 +00:00
.pre-commit-config.yaml update versions 2026-02-03 17:17:57 -05:00
CLAUDE.md feat: add private tessl tiles for codeflash rules, docs, and skills 2026-02-14 20:55:06 -05:00
codeflash.code-workspace improve codeflash debugging 2025-06-26 15:00:35 -07:00
MULTI_LANGUAGE_ARCHITECTURE.md refactor 2026-02-11 02:05:54 +05:30
mypy_allowlist.txt rename file name 2025-06-05 20:08:09 -07:00
pyproject.toml chore: disable ruff B009 globally to avoid conflict with mypy [misc] 2026-02-13 09:48:18 -05:00
README.md release/v0.17.0 (#756) 2025-09-23 14:02:30 -07:00
SECURITY.md Create SECURITY.md 2025-08-06 18:50:57 -07:00
tessl.json chore: improve skills to 100% review score and bump to v0.2.0 2026-02-14 21:07:24 -05:00
uv.lock chore: upgrade all dependencies in lockfile 2026-02-13 10:26:50 -05:00

README.md

Codeflash-banner

GitHub commit activity PyPI Downloads PyPI Downloads

Codeflash is a general purpose optimizer for Python that helps you improve the performance of your Python code while maintaining its correctness. It uses advanced LLMs to generate multiple optimization ideas for your code, tests them to be correct and benchmarks them for performance. It then creates merge-ready pull requests containing the best optimization found, which you can review and merge.

How to use Codeflash -

  • Optimize an entire existing codebase by running codeflash --all
  • Automate optimizing all future code you will write by installing Codeflash as a GitHub action.
  • Optimize a Python workflow python myscript.py end-to-end by running codeflash optimize myscript.py

Codeflash is used by top engineering teams at Pydantic (PRs Merged), Roboflow (PRs Merged 1, PRs Merged 2), Unstructured (PRs Merged 1, PRs Merged 2), Langflow (PRs Merged) and many others to ship performant, expert level code.

Codeflash is great at optimizing AI Agents, Computer Vision algorithms, PyTorch code, numerical code, backend code or anything else you might write with Python.

Installation

To install Codeflash, run:

pip install codeflash

Add codeflash as a development time dependency if you are using package managers like uv or poetry.

Quick Start

  1. To configure Codeflash for a project, at the root directory of your project where the pyproject.toml file is located, run:

    codeflash init
    • It will ask you a few questions about your project like the location of your code and tests
    • Ask you to generate an API Key to access Codeflash's LLMs
    • Install a GitHub app to open Pull Requests on GitHub.
    • Ask if you want to setup a GitHub actions which will optimize all your future code.
    • The codeflash config is then saved in the pyproject.toml file.

  2. Optimize your entire codebase:

    codeflash --all

    This can take a while to run for a large codebase, but it will keep opening PRs as it finds optimizations.

  3. Optimize a script:

    codeflash optimize myscript.py

Documentation

For detailed installation and usage instructions, visit our documentation at docs.codeflash.ai

Demo

  • Optimizing the performance of new code for a Pull Request through GitHub Actions. This lets you ship code quickly while ensuring it remains performant.

https://github.com/user-attachments/assets/38f44f4e-be1c-4f84-8db9-63d5ee3e61e5

  • Optiming a workflow end to end automatically with codeflash optimize

https://github.com/user-attachments/assets/355ba295-eb5a-453a-8968-7fb35c70d16c

Support

Join our community for support and discussions. If you have any questions, feel free to reach out to us using one of the following methods:

License

Codeflash is licensed under the BSL-1.1 License. See the LICENSE file for details.