whatisgithub

What is pyspur?

pyspur-dev/pyspur — explained in plain English

Analysis updated 2026-06-26

5,721TypeScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A visual canvas tool for building and testing AI agent workflows, where each step appears as a connected block you can run, inspect, and compare across prompt versions before deploying as an API.

Mindmap

mindmap
  root((pyspur))
    What it does
      Visual agent builder
      Test and compare runs
      Deploy as API
    Features
      Human-in-the-loop
      File and media input
      100 model providers
      RAG workflows
    Tech stack
      Python backend
      TypeScript frontend
      PostgreSQL
    Use cases
      AI prototyping
      Prompt iteration
      Agent deployment
Click or tap to explore — scroll the page freely

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

Build a multi-step AI workflow visually, run it on test cases, and compare outputs side by side across different prompt versions.

USE CASE 2

Set up a human-in-the-loop approval step that pauses an AI workflow until a person reviews and approves the output before it continues.

USE CASE 3

Connect an AI agent to Slack, GitHub, or Google Sheets and deploy the finished workflow as an API endpoint.

USE CASE 4

Create a RAG workflow that chunks and indexes your documents so the agent retrieves relevant pieces during a chat session.

What is it built with?

PythonTypeScriptPostgreSQLSQLite

How does it compare?

pyspur-dev/pyspurapertureless/vue-chartjsiyaja/llama-fs
Stars5,7215,7215,726
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires pip install pyspur, then runs a local server at port 6080, PostgreSQL recommended for production use.

License terms not mentioned in the explanation.

So what is it?

PySpur is a visual tool for building and testing AI agents, aimed at engineers who spend too much time tweaking prompts and staring at raw terminal output to figure out why an AI workflow is misbehaving. The idea is to give you a canvas where you can see each step of an AI workflow as a connected block, run it, inspect what happened at each node, and iterate quickly without writing a lot of glue code from scratch. The workflow is organized around four steps: define test cases, build the agent using either a Python file or the visual editor, run it repeatedly while adjusting things, and then deploy it as an API. Each of those steps has a corresponding view in the interface. You can run the same test case across multiple versions of a workflow side by side to compare outputs, which is useful when deciding whether a prompt change actually improved results. Feature-wise, PySpur supports pausing a workflow mid-run to wait for a human to review and approve output before continuing. It can process files, PDFs, videos, images, and audio. It includes tools for connecting to external services like Slack, GitHub, and Google Sheets. It also supports RAG workflows, which means you can feed it a collection of documents, have it chunk and index them, and then retrieve relevant pieces during a conversation or task. It connects to over 100 AI model providers, so you are not locked into a single vendor. Installing it locally takes three commands: pip install pyspur, initialize a project, and start the server. A local interface then opens at port 6080. The project recommends PostgreSQL for production stability but ships with SQLite for quick evaluation. PySpur is open source and written in Python for the backend logic, with a TypeScript frontend. Development setup instructions cover Unix-like systems only, Windows is not supported.

Copy-paste prompts

Prompt 1
I want to build an AI agent in PySpur that reads a PDF, summarizes each section, and posts the result to Slack. Walk me through setting up each node in the visual editor.
Prompt 2
How do I configure PySpur to run the same test case through two different prompt versions side by side so I can compare which gives better outputs?
Prompt 3
Set up a PySpur workflow with a human-approval checkpoint so a person must review the AI output before the rest of the workflow continues.
Prompt 4
Help me create a RAG workflow in PySpur that indexes my company documents and answers questions by retrieving the most relevant chunks.

Frequently asked questions

What is pyspur?

A visual canvas tool for building and testing AI agent workflows, where each step appears as a connected block you can run, inspect, and compare across prompt versions before deploying as an API.

What language is pyspur written in?

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

What license does pyspur use?

License terms not mentioned in the explanation.

How hard is pyspur to set up?

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

Who is pyspur for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.