{"id":30195029,"url":"https://github.com/ankit-verma-209171/contrimate","last_synced_at":"2025-08-13T03:24:47.424Z","repository":{"id":301782050,"uuid":"1010290060","full_name":"ankit-verma-209171/contrimate","owner":"ankit-verma-209171","description":"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.","archived":false,"fork":false,"pushed_at":"2025-06-28T19:05:37.000Z","size":49,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-28T20:22:12.809Z","etag":null,"topics":["find-issues","github-api","google-adk","open-source","python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ankit-verma-209171.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-28T18:52:19.000Z","updated_at":"2025-06-28T19:05:40.000Z","dependencies_parsed_at":"2025-06-29T06:15:53.284Z","dependency_job_id":null,"html_url":"https://github.com/ankit-verma-209171/contrimate","commit_stats":null,"previous_names":["ankit-verma-209171/contrimate"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ankit-verma-209171/contrimate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankit-verma-209171%2Fcontrimate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankit-verma-209171%2Fcontrimate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankit-verma-209171%2Fcontrimate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankit-verma-209171%2Fcontrimate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ankit-verma-209171","download_url":"https://codeload.github.com/ankit-verma-209171/contrimate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankit-verma-209171%2Fcontrimate/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270174305,"owners_count":24539745,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["find-issues","github-api","google-adk","open-source","python","python3"],"created_at":"2025-08-13T03:24:42.891Z","updated_at":"2025-08-13T03:24:47.370Z","avatar_url":"https://github.com/ankit-verma-209171.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ContriMate AI Agent\n\nContriMate 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.\n\n## Demo\n\n[![Watch the video in YouTube](https://img.youtube.com/vi/ur2Fk-IlIpk/0.jpg)](https://www.youtube.com/watch?v=ur2Fk-IlIpk)\n\n## Features\n\n- **Personalized Issue Discovery:** Find open issues in any GitHub repository based on your interests and technologies.\n- **Deep Contextual Summaries:** Summarizes issue details and comments for quick understanding.\n- **Direct Navigation:** Provides direct links to issues and comments for seamless exploration.\n- **Proactive Guidance:** Asks clarifying questions and offers next steps to help you contribute effectively.\n\n## Tech Stack\n\n- Python 3.13+\n- [Google ADK](https://pypi.org/project/google-adk/) (Gemini API)\n- [Pydantic](https://docs.pydantic.dev/) (for data models)\n- [Requests](https://docs.python-requests.org/) (for GitHub API)\n\n## Setup\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/ankit-verma-209171/contrimate.git\n   cd contrimate\n   ```\n2. **Sync dependencies using [uv](https://github.com/astral-sh/uv):**\n   ```bash\n   uv sync\n   ```\n3. **Activate the created virtual environment (recommended):**\n   ```bash\n   source .venv/bin/activate\n   ```\n4. **Configure environment variables:**\n   - Copy `.env.example` to `.env` and fill in your GitHub and Google API keys.\n   - Example:\n     ```env\n     GITHUB_TOKEN=your_github_token\n     GOOGLE_API_KEY=your_google_api_key\n     ```\n\n## Usage\n\nRun the main agent (using ADK web):\n\n```bash\nadk web\n```\n\n## Project Structure\n\n```\ncontrimate/\n├── contrimate_agent/        # Main agent logic and configuration\n├── libraries/               # Common utilities, models, and GitHub API tools\n│   ├── common/\n│   ├── models/\n│   └── tools/\n├── pyproject.toml\n├── uv.lock\n└── README.md\n```\n\n## Environment Variables\n\n- `GITHUB_TOKEN` — GitHub personal access token (required)\n- `GOOGLE_API_KEY` — Google Gemini API key (required)\n\n## License\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fankit-verma-209171%2Fcontrimate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fankit-verma-209171%2Fcontrimate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fankit-verma-209171%2Fcontrimate/lists"}