qodo-ai /qodo-cover

Qodo-Cover: An AI-Powered Tool for Automated Test Generation and Code Coverage Enhancement! 💻🤖🧪🐞

★ 5,688⑂ 573👁 36⑃ 210● 129▤ 50
PythonAGPL-3.0Created 2024-05-18qodo.ai/
Download: Release 0.3.10Release-0.3.10 ↓0.3.102025-05-21
+0
Daily
5,688
stars
573
forks
36
watchers
210
prs
129
issues
50
releases

README

Qodo Cover aims to help efficiently increase code coverage, by automatically generating qualified tests to extend code coverage. Qodo Cover can run in your GitHub CI workflow or locally as a CLI tool.





    
    
    
    


 Table of Contents
 News and Updates
 Overview
 Installation and Usage
 Contributing
 Documentation
 Roadmap


 News and Updates
 2025-06-15
 ⚠️ This repository is no longer maintained. Please fork it if you wish to continue development or use it in your own projects.

 2024-12-04:
New mode - Run Qodo Cover Pro in your GitHub CI workflow. Currently in preview and available for free for a limited time for Python projects, leveraging your own LLM API key from your favorite LLM provider. It's a practical way to improve code quality and reliability. For more details, reach out to the Qodo team.

 2024-11-05:
New mode - scan an entire repo, auto identify the test files, auto collect context for each test file, and extend the test suite with new tests.
See more details here.


 Qodo-Cover
Welcome to Qodo-Cover. This focused project utilizes Generative AI to automate and enhance the generation of tests (currently mostly unit tests), aiming to streamline development workflows. Qodo-Cover can run via a terminal, and is planned to be integrated into popular CI platforms.

We invite the community to collaborate and help extend the capabilities of Qodo Cover, continuing its development as a cutting-edge solution in the automated unit test generation domain. We also wish to inspire researchers to leverage this open-source tool to explore new test-generation techniques.


 Overview
This tool is part of a broader suite of utilities designed to automate the creation of unit tests for software projects. Utilizing advanced Generative AI models, it aims to simplify and expedite the testing process, ensuring high-quality software development. The system comprises several components:
1. Test Runner: Executes the command or scripts to run the test suite and generate code coverage reports.
2. Coverage Parser: Validates that code coverage increases as tests are added, ensuring that new tests contribute to the overall test effectiveness.
3. Prompt Builder: Gathers necessary data from the codebase and constructs the prompt to be passed to the Large Language Model (LLM).
4. AI Caller: Interacts with the LLM to generate tests based on the prompt provided.


 Installation and Usage
 Requirements
Before you begin, make sure you have the following:
- OPENAI_API_KEY set in your environment variables, which is required for calling the OpenAI API.
- Code Coverage tool: A Cobertura XML code coverage report is required for the tool to function correctly.
  - For example, in Python one could use pytest-cov. Add the --cov-report=xml option when running Pytest.
  - Note: We are actively working on adding more coverage types but please feel free to open a PR and contribute to cover_agent/CoverageProcessor.py

If running directly from the repository you will also

Top issues

Discussions

Latest release

Release 0.3.10 0.3.10 2025-05-21

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON