chfaker is an educational tool designed to simulate developer activity by programmatically generating commit history. It reads your local repository, creates an orphan branch, and populates it with AI-generated commits, perfectly mapping them to a realistic timeline.
THIS TOOL IS FOR EDUCATIONAL PURPOSES ONLY. The author takes no liability for the misuse of this software. Users are solely responsible for their actions and the integrity of their repository data. By proceeding, you acknowledge that force-pushing and branch deletion are irreversible operations. THE AUTHOR TAKES NO ACCOUNTABILITY FOR DATA LOSS OR REPOSITORY MISCONFIGURATION RESULTING FROM THE USE OF THIS TOOL.
- Python 3
- Git
Run the official installation script to set up the local AI engine:
curl -fsSL https://ollama.com/install.sh | sh
chfaker is optimized to run offline using the lightweight and fast qwen2.5:0.5b model:
ollama pull qwen2.5:0.5b
Place main.py in the root of the Git repository you wish to modify. Run the script using the following command structure:
python3 main.py --s YYYY-MM-DD --e YYYY-MM-DD --cc <NUMBER_OF_COMMITS>
To generate 20 commits spread organically between January 1st and June 1st, 2026:
python3 main.py --s 2026-01-01 --e 2026-06-01 --cc 20