Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.codeflash.ai/llms.txt

Use this file to discover all available pages before exploring further.

Codeflash speeds up your code by figuring out the best way to rewrite it while verifying that the behavior is unchanged, and verifying real speed gains through performance benchmarking. It supports Python, JavaScript, TypeScript, and Java. The optimizations Codeflash finds are generally better algorithms, opportunities to remove wasteful compute, better logic, utilizing caching and utilization of more efficient library methods. Codeflash does not modify the system architecture of your code, but it tries to find the most efficient implementation of your current architecture.

​
Get Started

Pick your language to install and configure Codeflash:

Python

Install via pip, uv, or poetry. Configure in pyproject.toml.

JavaScript / TypeScript

Install via npm, yarn, pnpm, or bun. Configure in package.json. Supports Jest, Vitest, and Mocha.

Java

Install via uv. Supports Maven and Gradle. JUnit 5, JUnit 4, and TestNG.

​
How to use Codeflash

These commands work for Python, JS/TS, and Java projects:

Optimize a Function

codeflash --file path/to/file --function my_function

Optimize Entire Codebase

codeflash --all

Trace & Optimize Workflows

codeflash optimize myscript.py

Auto-Optimize Pull Requests

codeflash init-actions

​
Configuration Reference

Python Config

pyproject.toml reference

JS / TS Config

package.json reference — includes monorepo, scattered tests, manual setup

Java Config

pom.xml / gradle.properties reference

​
How does Codeflash verify correctness?

Codeflash verifies the correctness of the optimizations it finds by generating and running new regression tests, as well as any existing tests you may already have. Codeflash tries to ensure that your code behaves the same way before and after the optimization. This offers high confidence that the behavior of your code remains unchanged.

​
Continuous Optimization

Because Codeflash is an automated process, the main way to use it is by installing it as a GitHub action and have it optimize the new code on every pull request. When Codeflash finds an optimization, it will ask you to review it. It will write a detailed explanation of the changes it made, and include all relevant info like % speed increase and proofs of correctness. This is a great way to ensure that your code, your team’s code and your AI Agent’s code are optimized for performance before it causes a performance regression. We call this Continuous Optimization.

​
Questions or Feedback?

Your feedback will help us make codeflash better, faster. If you have any questions or feedback, use the Intercom button in the lower right, join our Discord, or drop us a note at contact@codeflash.ai - we read every message!