A newer version of the Gradio SDK is available:
5.35.0
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
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.
Usage
Install the OpenSorus GitHub App.
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.
Once, you're done installing, there are primarily two ways to use the agent:
🔁 Option 1 (Quicker): Auto-trigger via GitHub mention
In any issue, simply comment
@opensorus.The agent reads your issue, understands your repo, and replies back within seconds.
💻 Option 2: Use the Gradio UI on HF Spaces
Visit this space.
Paste your GitHub issue URL.
Enter the primary branch name (e.g., main or master).
Click Run Agent 🚀.
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 on HF.
You can also open an issue on GitHub.
Acknowledgements
Made with ❤️ by Aditi Bindal
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.