We're excited you're interested in contributing to Specif AI! This document outlines the process for contributing to our project. We welcome contributions from everyone, whether you're fixing a typo, improving documentation, or adding a new feature.
- Fork the repository on GitHub.
- Clone your fork locally:
git clone https://github.com/presidio-oss/specif-ai cd https://github.com/presidio-oss/specif-ai
- To set up and run the application locally, follow the guides provided for:
- Backend: Backend setup guide
- Electron: Electron setup guide
- Create a new branch for your changes:
git checkout -b your-branch-name
- Make your changes in the codebase:
- UI Changes: Make your UI code file changes in the
ui/
andelectron/
folders respectively. - Backend Changes: Make backend changes in
backend/
folder.
- UI Changes: Make your UI code file changes in the
- Write or update tests as necessary.
- Format your code.
- Run linting checks.
- Commit your changes:
git commit -m "Your detailed commit message"
- Push to your fork:
git push origin your-branch-name
- Submit a pull request through the GitHub website to
- Provide a clear title and description of your changes.
- Include any relevant issue numbers in the PR description.
- Ensure all tests pass and there are no linting errors.
- Update documentation if you're changing functionality.
Before submitting a pull request, verify the changes in your local environment.
Use the GitHub issue tracker at to report bugs. When filing an issue, please include:
- A clear title and description.
- As much relevant information as possible.
- A code sample or an executable test case demonstrating the expected behavior that is not occurring.
Feature requests are welcome. Please provide a clear description of the feature and why it would be beneficial to the project. You can submit feature requests through the GitHub issue tracker.
If you have any questions, feel free to open an issue or reach out to the maintainers through the GitHub repository.
Thank you for contributing to Specif AI!