---
title: OpenSorus - OSS Maintainer Agent
emoji: ⚡️
colorFrom: yellow
colorTo: red
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: true
license: mit
short_description: GitHub Issues Maintainer Agent for Open Source Projects
---
# OpenSorus - AI Maintainer Agent for GitHub Issues
<p align="center"><img width="65%" src="https://res.cloudinary.com/ivolve/image/upload/v1749392337/opensorus-banner_wel6po.jpg"/></p>

> The OSS Copilot for automated triage & instant GitHub issue support with helpful context aware replies.

OpenSorus is an AI Agent distributed as a GitHub App that reads your GitHub issues, understands your codebase, and responds with a comment to help your users/contributors. It acts like a first-level dev support assistant of your project that never sleeps and actually understands your codebase.

> A submission for agent-demo-track.

## Features

Once installed and triggered on a GitHub issue (either via @mention or through the Gradio interface), OpenSorus autonomously:

- Pulls issue context from GitHub

- Indexes relevant parts of your codebase to match with the issue using semantic similarity search mechanisms.

- Retrieves relevant code snippets or docs from the repo.

- Crafts a useful, relevant reply by using the context from the codebase and generative capabilities of its own.

- Posts the response back as a GitHub comment.

## Goal
Open source projects often get overwhelmed with open issues, thanks to their inclusive and collaborative nature. But that openness should feel empowering, not exhausting, for all, including maintainers & contributors.

OpenSorus aims to make the life of open-source projects a little easier by handling the P1-level issues.
Built for open source maintainers & teams who want to reduce issue backlog, increase community engagement and free up time to focus on critical issues.

## Demo Video
🎥 Watch the [Demo Video here](https://www.loom.com/share/d39697a60b944dbb938c3952d66cdc62?sid=1e730996-c912-4089-b717-a42ac9fbfe25).


## Usage
-  Install the [OpenSorus GitHub App](https://github.com/apps/opensorus).

-  Configure this app for a particular repository by giving access to the repo from the dropdown.

> Follow this guide to learn more about how to [install GitHub apps](https://docs.github.com/en/apps/using-github-apps/installing-a-github-app-from-a-third-party#installing-a-github-app).

Once, you're done installing, there are primarily two ways to use the agent:
### 🔁 Option 1 (Quicker): Auto-trigger via GitHub mention
1. In any issue, simply comment `@opensorus`.

2. The agent reads your issue, understands your repo, and replies back within seconds.

### 💻 Option 2: Use the Gradio UI on HF Spaces
1. Visit this [space](https://huggingface.co/spaces/Agents-MCP-Hackathon/OpenSorus).
2. Paste your GitHub issue URL.

3. Enter the primary branch name (e.g., main or master).

4. Click Run Agent 🚀.
5. Agent logs back a success message, & you're done!

(Check back the issue's comments for updates).

## Tech Stack

Here’s the tech stack that made it all possible:

🧠 LLM: Devstral (via Mistral API 🧡)

🧬 Embeddings Generation: Codestral-Embed (via Mistral API 🧡)

🗂️ Indexing, Embeddings storage & retrieval: LlamaIndex 🦙

🔎 Querying Context: Codestral (via Mistral API 🧡) + LlamaIndex 🦙

🧱 Infra Provider: Modal Labs

🛠️ GitHub Integration:	GitHub REST API

✨ Web Interface: Gradio UI + Hugging Face Spaces


## Limitations
- Expects a well defined issue description for a better response. Vague descriptions may result in unhelpful/vague/irrelevant comment.

- Rate limits may apply if too many requests come frequently.

- Currently optimized for small-mid scale repositories. Might lag or take longer on large/heavy codebases. 

- Only reads issue description as a context, not any further comments on the issue.

- Doesn’t handle PRs or other discussions yet (only issues for now).

## Support
For any feedback, support or bug report:
- Feel free to [open a discussion](https://huggingface.co/spaces/Agents-MCP-Hackathon/OpenSorus/discussions?status=open&type=discussion&sort=recently-created) on HF.

- You can also [open an issue](https://github.com/aditi-dsi/opensorus) on GitHub.

- Or feel free to reach out via DM on [X](https://x.com/halfacupoftea_) or [LinkedIn](https://www.linkedin.com/in/aditi-bindal/).


## Acknowledgements
Made with ❤️ by [Aditi Bindal](https://huggingface.co/halfacupoftea)

Big Thanks to Mistral AI & LlamaIndex for incredible LLMs and Agentic tools and to Hugging Face for providing the opportunitiy to build this agent.

And special shoutout to ChatGPT for designing such a cute logo!


## License
This project is licensed under the MIT License – see the LICENSE file for details.