1. Install
Install the app for your organization or selected repositories using the GitHub App installation flow.
Auto-suggest the best assignee for every new issue.
Triavo analyzes repository activity and semantic commit context to recommend the most relevant contributor for newly opened issues.
Teams can review the recommendation immediately and apply it with /triavo assign.
Quickstart
Connect Triavo to your repository, open an issue, and let Triavo post an assignee suggestion based on contribution history and semantic relevance.
2. Open issue
Create a new issue in an installed repository. Triavo automatically starts analysis.
3. Review recommendation
Triavo comments with the top contributor match and ranking-backed suggestion.
4. Apply assignment
Comment /triavo assign to let Triavo assign the suggested contributor if they are assignable.
How Triavo Works
Triavo turns webhook events into automated issue triage decisions.
- GitHub sends signed events to
/webhook. - Triavo validates signature and deduplicates delivery IDs.
- Issue open events trigger contributor ranking and semantic matching.
- Push events store commit embeddings for future issue similarity lookups.
- Triavo posts suggestion comments and supports command-driven assignment.
Signal blend: baseline contribution + semantic similarity + expertise boost - workload penalty.
Architecture Snapshot
API Layer
FastAPI service handles webhooks, scoring orchestration, and public status endpoints.
Primary Data
PostgreSQL stores webhook dedupe records and recommendation history.
Semantic Search
Qdrant stores commit embeddings and supports similarity queries for issue text.
GitHub Integration
GitHub API is used for contributors, commits, PRs, comments, and assignment actions.
Security and Data Controls
Triavo enforces webhook authenticity checks and limits processing to required repository activity for service functionality.
- HMAC signature verification via
X-Hub-Signature-256 - Unique webhook delivery tracking
- Credential-based access to GitHub, PostgreSQL, and Qdrant
- Infrastructure-hosted encryption in transit and controlled service access
FAQ
Why no suggestion posted?
Confirm app installation permissions, webhook secret correctness, and health readiness for dependencies.
Why assignment did not happen?
Use exact command /triavo assign and ensure the suggested user is assignable in the repository.
Where is full setup guidance?
Use the complete implementation guide at the documentation page.
Where are legal terms?
Privacy data handling details are published in the Privacy Policy page.