-
Fork the PictoPy repository: https://github.com/AOSSIE-Org/PictoPy
-
Open your terminal (or Powershell with administrator privileges on Windows)
-
Clone your forked repository:
git clone https://github.com/yourUsername/PictoPy
-
Change to the repository directory:
cd PictoPy -
Add the main repository as "upstream":
git remote add upstream https://github.com/AOSSIE-Org/PictoPy
-
Run the Automatic Setup
npm run setup
Note: This step can take a long time depending on your internet connection and system specifications. If the script seems to stop progressing after waiting for more than 10 minutes, press Enter in your terminal window to continue.
-
Start the Backend Server
cd .\backend .env\Scripts\activate.ps1 fastapi dev
cd ./backend source .env/bin/activate fastapi dev
-
Start the Frontend Desktop App
Open a new terminal window, navigate to the project directory, and run:
cd frontend npm run tauri dev -
Pre-commit Setup
Before running the
git commitcommand, ensure you have the following Python packages installed globally:pip install ruff black mypy pre-commit
Note: If you are committing from a virtual environment, these packages should already be installed as they are included in the requirements.txt file.