ZapGit is aimed at creating an all-in-one place for you to manage and plan tasks like creating and commenting issues and pull requests on GitHub, using Zapier MCP servers and LlamaIndex.
The first step, common to both the Docker and the source code setup approaches, is to clone the repository and access it:
git clone https://github.com/AstraBert/zapgit.git
cd zapgitOnce there, you can choose one of the two following approaches:
Required: Docker and docker compose
- Add the
groq_api_keyvariable in the.env.examplefile and modify the name of the file to.env. Get these keys:
mv .env.example .env- Launch the Docker application:
# If you are on Linux/macOS
bash start_services.sh
# If you are on Windows
.\start_services.ps1- Or do it manually:
docker compose up -f compose.local.yaml redis -d
docker compose up -f compose.local.yaml zapbackend -d
docker compose up -f compose.local.yaml zapfrontend -dYou will see the application running on http://localhost:8501 and you will be able to use it. Depending on your connection and on your hardware, the set up might take some time (up to 15 mins to set up) - but this is only for the first time your run it!
Required: Docker, docker compose and conda
- Add the
groq_api_keyvariable in the.env.examplefile and modify the name of the file to.env. Get these keys:
mv .env.example scripts/.env- Set up the app using the dedicated script:
# For MacOs/Linux users
bash setup.sh
# For Windows users
.\setup.ps1- Or you can do it manually, if you prefer:
docker compose up -f compose.local.yaml redis -d
conda env create -f environment.local.yml
conda activate zapgit
cd scripts/
uvicorn api:app --host 0.0.0.0 --port 8000
conda deactivate- Now you can open another terminal and run:
conda activate zapgit
cd scripts/
streamlit run frontend.py
conda deactivateYou will see the application running on http://localhost:8501 and you will be able to use it.
- Redis is used for API rate limiting control
The workflow is very simple:
- When you submit a request, the request gets routed to a template prompt, which is completed based on the request details (thanks to banks)
- The chosen prompt is passed on to an Agent, which connects to Zapier MCP servers and starts executing all the commands contained in your requests
- Once the agent is done, it returns to you a final response and its agentic process. You should now see the action (create comment/issue/PR) on GitHub, a message on Discord detailing the action and a reminder event planned on Calendar.
Contributions are always welcome! Follow the contributions guidelines reported here.
The software is provided under MIT license.