https://github.com/ankit-verma-209171/contrimate
AI-powered assistant that helps developers discover, understand, and navigate open GitHub issues tailored to their tech stack and interests, with proactive guidance and contextual summaries.
https://github.com/ankit-verma-209171/contrimate
find-issues github-api google-adk open-source python python3
Last synced: about 2 months ago
JSON representation
AI-powered assistant that helps developers discover, understand, and navigate open GitHub issues tailored to their tech stack and interests, with proactive guidance and contextual summaries.
- Host: GitHub
- URL: https://github.com/ankit-verma-209171/contrimate
- Owner: ankit-verma-209171
- License: mit
- Created: 2025-06-28T18:52:19.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-28T19:05:37.000Z (4 months ago)
- Last Synced: 2025-06-28T20:22:12.809Z (4 months ago)
- Topics: find-issues, github-api, google-adk, open-source, python, python3
- Language: Python
- Homepage:
- Size: 47.9 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ContriMate AI Agent
ContriMate is an AI-powered assistant that helps developers discover, understand, and navigate open GitHub issues tailored to their tech stack, interests, and focus areas. It proactively guides users to suitable issues, summarizes discussions, and provides actionable suggestions with direct links for easy access.
## Demo
[](https://www.youtube.com/watch?v=ur2Fk-IlIpk)
## Features
- **Personalized Issue Discovery:** Find open issues in any GitHub repository based on your interests and technologies.
- **Deep Contextual Summaries:** Summarizes issue details and comments for quick understanding.
- **Direct Navigation:** Provides direct links to issues and comments for seamless exploration.
- **Proactive Guidance:** Asks clarifying questions and offers next steps to help you contribute effectively.
## Tech Stack
- Python 3.13+
- [Google ADK](https://pypi.org/project/google-adk/) (Gemini API)
- [Pydantic](https://docs.pydantic.dev/) (for data models)
- [Requests](https://docs.python-requests.org/) (for GitHub API)
## Setup
1. **Clone the repository:**
```bash
git clone https://github.com/ankit-verma-209171/contrimate.git
cd contrimate
```
2. **Sync dependencies using [uv](https://github.com/astral-sh/uv):**
```bash
uv sync
```
3. **Activate the created virtual environment (recommended):**
```bash
source .venv/bin/activate
```
4. **Configure environment variables:**
- Copy `.env.example` to `.env` and fill in your GitHub and Google API keys.
- Example:
```env
GITHUB_TOKEN=your_github_token
GOOGLE_API_KEY=your_google_api_key
```
## Usage
Run the main agent (using ADK web):
```bash
adk web
```
## Project Structure
```
contrimate/
├── contrimate_agent/ # Main agent logic and configuration
├── libraries/ # Common utilities, models, and GitHub API tools
│ ├── common/
│ ├── models/
│ └── tools/
├── pyproject.toml
├── uv.lock
└── README.md
```
## Environment Variables
- `GITHUB_TOKEN` — GitHub personal access token (required)
- `GOOGLE_API_KEY` — Google Gemini API key (required)
## License
MIT License