An open API service indexing awesome lists of open source software.

https://github.com/alaa2133/cobra

[SIGGRAPH 2025] Official code of the paper "Cobra: Efficient Line Art COlorization with BRoAder References"
https://github.com/alaa2133/cobra

cli cobra-generator cobra-toolbox code-audit go golang-library modeling posix-compliant-flags python sbml security-scanner strain-engineering subcommands transcriptomics

Last synced: 6 months ago
JSON representation

[SIGGRAPH 2025] Official code of the paper "Cobra: Efficient Line Art COlorization with BRoAder References"

Awesome Lists containing this project

README

          

# Cobra: Efficient Line Art Colorization with Broader References ๐ŸŽจ

![Cobra Logo](https://img.shields.io/badge/Cobra-Efficient%20Line%20Art%20Colorization-brightgreen)

Welcome to the official code repository for the paper **"Cobra: Efficient Line Art Colorization with Broader References"** presented at SIGGRAPH 2025. This repository contains the code and resources needed to replicate our findings and utilize our colorization methods in your own projects.

## Table of Contents

- [Introduction](#introduction)
- [Installation](#installation)
- [Usage](#usage)
- [Features](#features)
- [Results](#results)
- [Contributing](#contributing)
- [License](#license)
- [Acknowledgments](#acknowledgments)

## Introduction

Line art has a unique charm and versatility in visual communication. However, colorizing line art efficiently remains a challenge. Our paper presents **Cobra**, a novel approach to colorization that leverages broader references for improved results. This repository serves as a practical guide to implementing our methods and achieving high-quality colorization in your projects.

## Installation

To get started with Cobra, follow these steps:

1. **Clone the Repository**

```bash
git clone https://github.com/alaa2133/Cobra.git
cd Cobra
```

2. **Install Dependencies**

Ensure you have Python 3.7 or higher installed. Then, install the required libraries:

```bash
pip install -r requirements.txt
```

3. **Download the Model**

You can download the model from our [Releases section](https://github.com/alaa2133/Cobra/releases). Make sure to follow the instructions in the release notes for proper execution.

## Usage

Using Cobra for colorization is straightforward. Hereโ€™s how to do it:

1. **Prepare Your Line Art**

Ensure your line art is in a compatible format (e.g., PNG, JPEG). Place your images in the `input_images` directory.

2. **Run the Colorization Script**

Execute the following command in your terminal:

```bash
python colorize.py --input_dir input_images --output_dir output_images
```

3. **View Results**

Your colorized images will be saved in the `output_images` directory. You can check them out to see the results of the colorization process.

## Features

- **Efficient Processing**: Cobra optimizes the colorization process, allowing for quick results without sacrificing quality.
- **Broader References**: Our method utilizes broader references to enhance the colorization accuracy, producing visually appealing outcomes.
- **User-Friendly Interface**: The provided scripts are easy to use, making it accessible for users of all skill levels.
- **High-Quality Outputs**: Achieve professional-grade colorization for your line art.

## Results

Here are some examples of the colorization results achieved using Cobra:

![Colorization Example 1](https://example.com/colorization1.png)
![Colorization Example 2](https://example.com/colorization2.png)
![Colorization Example 3](https://example.com/colorization3.png)

These images showcase the effectiveness of our approach in transforming simple line art into vibrant, colorful illustrations.

## Contributing

We welcome contributions from the community! If you have ideas for improvements or new features, feel free to fork the repository and submit a pull request. Please ensure your contributions adhere to the following guidelines:

- Write clear, concise commit messages.
- Document your code.
- Ensure that all tests pass before submitting your changes.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Acknowledgments

We would like to thank our collaborators and mentors for their invaluable support throughout this project. Special thanks to the SIGGRAPH community for providing a platform to share our work.

For more information, visit our [Releases section](https://github.com/alaa2133/Cobra/releases) to download the necessary files and execute them properly.

Thank you for your interest in Cobra! We look forward to seeing how you utilize our work in your own projects. If you have any questions or feedback, feel free to reach out.

---

Happy Colorizing! ๐ŸŒˆ