# video-use Contribution Guide: How to Contribute to the browser-use Repository

> Learn how to contribute to the video-use project. Follow standard GitHub workflows like forking and pull requests, adhering to Python code conventions for the browser-use repository.

- Repository: [Browser Use/video-use](https://github.com/browser-use/video-use)
- Tags: how-to-guide
- Published: 2026-07-10

---

**The video-use repository does not contain a formal CONTRIBUTING.md file, so contributors must follow standard GitHub workflows including forking the repository, creating feature branches, and submitting pull requests while adhering to the Python code conventions established in the `helpers/` directory.**

The browser-use/video-use project is a pure Python toolkit for video automation that manages dependencies via [`pyproject.toml`](https://github.com/browser-use/video-use/blob/main/pyproject.toml) and organizes utility scripts within the `helpers/` directory. While the repository lacks an explicit contribution guide, understanding the existing file structure and following established open-source practices will allow you to submit successful contributions.

## Project Structure and Prerequisites

Before contributing, familiarize yourself with the repository layout. The project is built as a standard Python package with the following key characteristics:

- **Entry Point**: The [`README.md`](https://github.com/browser-use/video-use/blob/main/README.md) contains general project overview and installation instructions.
- **Configuration**: Dependency management and build settings are defined in [`pyproject.toml`](https://github.com/browser-use/video-use/blob/main/pyproject.toml).
- **Helper Scripts**: Utility functions are organized under `helpers/`, including [`helpers/transcribe.py`](https://github.com/browser-use/video-use/blob/main/helpers/transcribe.py) for audio-to-text processing and [`helpers/render.py`](https://github.com/browser-use/video-use/blob/main/helpers/render.py) for video rendering.
- **Documentation**: Additional reference guides exist under [`skills/manim-video/README.md`](https://github.com/browser-use/video-use/blob/main/skills/manim-video/README.md), though these focus on specific skill implementations rather than contribution workflows.

The codebase is pure Python, so you will need a working Python environment and familiarity with `git` workflows.

## Step-by-Step video-use Contribution Workflow

Since no formal contribution guide exists in the repository, follow these standard open-source steps to submit your changes:

### 1. Fork and Clone the Repository

Create a personal copy of the repository on your GitHub account, then clone it locally:

```bash
git clone https://github.com/<your-username>/video-use.git
cd video-use

```

### 2. Create a Feature Branch

Isolate your changes on a dedicated branch to keep the main branch history clean:

```bash
git checkout -b my-feature

```

### 3. Implement Changes Following Existing Style

Edit or add code consistent with the existing Python style found in [`helpers/transcribe.py`](https://github.com/browser-use/video-use/blob/main/helpers/transcribe.py) and [`helpers/render.py`](https://github.com/browser-use/video-use/blob/main/helpers/render.py). The project stores utility functions in the `helpers/` directory, so new utilities should follow this pattern.

### 4. Verify Functionality with Helper Scripts

Test your changes by running the existing helper scripts to ensure no regressions occur:

```bash

# Example: test transcription functionality

python helpers/transcribe.py input.txt output.txt

# Example: verify rendering utilities

python helpers/render.py --input my_video.mp4 --output rendered_video.mp4

```

### 5. Add Tests (Recommended)

While the repository currently does not bundle a formal test suite, adding unit tests for new functionality is strongly encouraged to maintain code quality.

### 6. Commit and Push

Stage your changes with a clear, descriptive commit message:

```bash
git add .
git commit -m "Add my_helper utility for X"
git push origin my-feature

```

### 7. Open a Pull Request

Navigate to the original browser-use/video-use repository and open a Pull Request (PR) against the `main` branch. Your PR description should clearly state what the change does, why it is needed, and reference any related issues.

### 8. Respond to Review Feedback

Maintainers will review your PR; address any requested changes promptly to facilitate merging.

## Key Files Reference

Understanding these files is essential for successful contributions:

| File | Purpose |
|------|---------|
| [`README.md`](https://github.com/browser-use/video-use/blob/main/README.md) | General project overview, installation instructions, and usage examples. |
| [`pyproject.toml`](https://github.com/browser-use/video-use/blob/main/pyproject.toml) | Project metadata, dependencies, and build system configuration. |
| [`helpers/transcribe.py`](https://github.com/browser-use/video-use/blob/main/helpers/transcribe.py) | Audio-to-text transcription utility demonstrating project coding standards. |
| [`helpers/render.py`](https://github.com/browser-use/video-use/blob/main/helpers/render.py) | Video rendering and processing helper showing expected function signatures. |
| [`skills/manim-video/README.md`](https://github.com/browser-use/video-use/blob/main/skills/manim-video/README.md) | Documentation for the manim-video skill set (reference only). |

## Summary

- **No CONTRIBUTING.md exists**, requiring contributors to follow standard GitHub workflows.
- **Fork, branch, and PR** is the required submission path against the `main` branch.
- **Code style** should match the Python conventions visible in [`helpers/transcribe.py`](https://github.com/browser-use/video-use/blob/main/helpers/transcribe.py) and [`helpers/render.py`](https://github.com/browser-use/video-use/blob/main/helpers/render.py).
- **Testing** relies on running helper scripts directly, though adding unit tests is encouraged.
- **Key configuration** lives in [`pyproject.toml`](https://github.com/browser-use/video-use/blob/main/pyproject.toml), while documentation resides in [`README.md`](https://github.com/browser-use/video-use/blob/main/README.md).

## Frequently Asked Questions

### Does video-use have a CONTRIBUTING.md file?

No, the video-use repository does not contain a [`CONTRIBUTING.md`](https://github.com/browser-use/video-use/blob/main/CONTRIBUTING.md) file or any explicit contribution guide. Contributors should follow standard open-source GitHub workflows as outlined in the repository's [`README.md`](https://github.com/browser-use/video-use/blob/main/README.md) and observe the code patterns present in the `helpers/` directory.

### How should I test my changes before submitting a PR?

You should run the existing helper scripts to verify functionality. For example, execute `python helpers/transcribe.py` or `python helpers/render.py` with appropriate arguments to ensure your changes do not break existing features. Although no formal test suite exists, adding unit tests for new functionality is recommended.

### What coding standards should I follow for video-use contributions?

Follow the Python coding standards visible in the existing helper files such as [`helpers/transcribe.py`](https://github.com/browser-use/video-use/blob/main/helpers/transcribe.py) and [`helpers/render.py`](https://github.com/browser-use/video-use/blob/main/helpers/render.py). The project uses [`pyproject.toml`](https://github.com/browser-use/video-use/blob/main/pyproject.toml) for packaging configuration, so ensure any new dependencies are properly declared there. Maintain consistency with the existing function signatures and documentation style found in the `helpers/` directory.

### Where should I discuss large changes before implementing them?

Open an issue in the browser-use/video-use repository to discuss significant architectural changes or new features before writing code. This allows maintainers to provide feedback on your proposal and ensures your contribution aligns with the project's direction.