Thanks for your interest in contributing! Here's how to get started.
- Fork and clone the repo
git clone https://github.com/YOUR_USERNAME/video-composer-agent.git
cd video-composer-agent
- Install dependencies with uv
pip install uv
uv sync
- Set up pre-commit hooks
uv pip install pre-commit
pre-commit install
We use several tools to ensure code quality:
- Ruff for linting and formatting
- Pre-commit hooks for automated checks
- YAML/TOML validation
- Automatic dependency updates with uv
The pre-commit hooks will run automatically when you commit. You can also run them manually:
pre-commit run --all-files
- Create a new branch for your feature
git checkout -b feature/your-feature-name
- Make your changes and commit them
git add .
git commit -m "feat: your descriptive commit message"
-
Push to your fork and create a Pull Request
-
Ensure your PR:
- Passes all pre-commit checks
- Includes relevant tests if adding new functionality
- Updates documentation as needed
- Has a clear description of the changes
- Copy
.env.example
to.env
cp .env.example .env
- Add your API keys and other required variables
- Never commit your
.env
file
- Join our Discord
- Check existing issues and PRs
- Create an issue for discussion