whatisgithub

What is reqsolve?

perfa01/reqsolve — explained in plain English

Analysis updated 2026-05-18

2TypeScriptAudience · ops devopsComplexity · 4/5Setup · moderate

In one sentence

A self-hosted, multi-department ticketing system with optional AI assistance from any provider and a semantic knowledge base.

Mindmap

mindmap
  root((repo))
    What it does
      Tickets and requests
      Department isolation
      Semantic knowledge base
      Email to ticket
    Tech stack
      TypeScript
      Docker
      Postgres
      Ollama
    Use cases
      IT helpdesk
      HR request tracking
      Facilities ticketing
    Audience
      IT admins
      Support teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a self-hosted helpdesk for multiple departments with strict data isolation.

USE CASE 2

Turn inbound email into tickets automatically through IMAP or Gmail OAuth.

USE CASE 3

Use AI to draft replies, summarize threads, and suggest solutions from your knowledge base.

USE CASE 4

Track SLAs, priorities, and overdue tickets across teams with dashboards.

What is it built with?

TypeScriptDockerPostgreSQLOllamapgvector

How does it compare?

perfa01/reqsolveadun-denton/chinvatagbara286/saint-cms
Stars222
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity4/54/52/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker Compose, 4GB+ RAM, and a required ENCRYPTION_KEY before any secrets can be saved.

So what is it?

ReqSolve is a self hosted ticketing and request management system built for organizations with multiple departments, such as IT, HR, Finance, and Facilities. It is meant to replace shared email inboxes and older ticketing tools, while keeping all your data on your own servers instead of someone else's cloud. The system offers tickets and formal request forms, with queues, filters, saved views, priorities, due dates, service level agreement tracking, tags, and a full history of changes. It can automatically tell whether an incoming message is a simple ticket or a more formal request and pre fill the right fields for a staff member to review. AI features are entirely optional and can draw on your own knowledge base to suggest solutions, draft replies, summarize long conversations, detect priority, and clean up notes. You choose which AI provider powers these features, including Anthropic, OpenAI, Google Gemini, several others, or a locally run Ollama model, and everything else in the system still works fine if you skip AI entirely. Resolved cases can become searchable knowledge base articles, and search works by meaning rather than just matching keywords, using a local embedding model. Departments are kept strictly separate on the server, so one team's tickets, knowledge, and AI context can never be seen by another. You can connect an email inbox so incoming mail becomes tickets automatically, and the system includes dashboards for team workload and overdue items, along with an interface fully translated into English and German. To run ReqSolve you need Docker and Docker Compose, along with at least 2 CPU cores and 4 gigabytes of memory. Setup means cloning the repository, copying an example configuration file, filling in a required encryption key that protects stored passwords and API keys, and running one Docker Compose command, which starts a Postgres database, a local embeddings service, and the app itself. The first visit to the app is empty until you create an administrator account and start configuring your own departments and settings.

Copy-paste prompts

Prompt 1
Walk me through deploying ReqSolve with Docker Compose and setting the required encryption key.
Prompt 2
Explain how department isolation keeps one team's tickets from another team's AI context.
Prompt 3
Show me how to connect my own AI provider, like Ollama or Anthropic, in the admin settings.
Prompt 4
Help me set up email polling so inbound support mail becomes tickets.
Prompt 5
Explain how the semantic knowledge base search works using pgvector embeddings.

Frequently asked questions

What is reqsolve?

A self-hosted, multi-department ticketing system with optional AI assistance from any provider and a semantic knowledge base.

What language is reqsolve written in?

Mainly TypeScript. The stack also includes TypeScript, Docker, PostgreSQL.

How hard is reqsolve to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is reqsolve for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.