# Contributing

Contributions are welcome and appreciated. Here's how to get involved.

## Getting Started

1. Fork the repository
2. Create a branch: `git checkout -b feature/<feature-name>`
3. Make your changes
4. Test thoroughly
5. Commit: `git commit -m 'feat(<scope>): short description'`
6. Push your branch and open a Pull Request

## Guidelines

- Keep changes focused — one feature or fix per PR
- Write clear commit messages
- Don't introduce external dependencies unless necessary
- If adding a new feature, update documentation to reflect it
- Follow the existing code style

## Reporting Issues

Open an issue and include:
- Your OS and runtime version (e.g. `go version` and/or `python3 -V`)
- The exact command used and the full output
- A screenshot or log if applicable

## Pull Requests

All PRs are reviewed. Small fixes are just as welcome as large features. If you're planning something significant, open an issue first to discuss the direction.