git404hub

what is dev-pulse fr?

rinilkunhiraman/dev-pulse — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · moderate

tl;dr

An AI agent that answers plain-English questions about software release notes, citing the exact version behind each fact, refreshed weekly.

vibe map

mindmap
  root((DevPulse))
    What it does
      Ask questions about release notes
      Cites exact version per fact
      Weekly auto refresh
    Tech stack
      Python
      Ollama
      Pydantic AI
      Streamlit
      DuckDB
    Use cases
      Track breaking changes across tools
      Search release notes in plain English
      Monitor AI agent performance
    Audience
      Developers
      Data and ML learners
    Evaluation
      Hybrid search plus reranking wins
      Simple prompt beats cautious prompt

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 make with this?

VIBE 1

Ask what breaking changes shipped in a specific release of a tool you depend on.

VIBE 2

Search across ten popular open source projects' release notes with one chat interface.

VIBE 3

Study a working example of a retrieval-augmented AI agent with evaluation and monitoring built in.

what's the stack?

PythonOllamaPydantic AIStreamlitDuckDBKestra

how it stacks up fr

rinilkunhiraman/dev-pulse0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

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

how do i run it?

Difficulty · moderate time til it works · 1h+

Requires uv, a running Ollama instance with a chat model, and about 2GB of disk space.

in plain english

DevPulse is a project that lets you ask plain English questions about software release notes and get back answers that cite the exact version where a change happened. It was built as a capstone project for a course called LLM Zoomcamp. The idea addresses a real problem: developers rely on many open source tools that release updates constantly, and nobody has time to read every changelog, yet missing an important breaking change can cause problems in production. The system works by pulling release notes from the GitHub Releases page of ten popular open source projects, including Node.js, React, Next.js, Docker Compose, and TypeScript, covering close to 1,800 individual releases. Those notes are broken into chunks and indexed two ways: a traditional keyword based search and a vector search that captures meaning rather than exact words, with the two combined for better results and then reordered by a separate reranking step to surface the most relevant chunks. An AI agent built with Pydantic AI decides which project to search for a given question, can run multiple searches if needed, and always cites the specific release version behind each fact it states. A scheduled workflow refreshes this whole knowledge base automatically every week so answers stay current. The project includes a formal evaluation comparing different search methods, finding that combining keyword and vector search with reranking performed best, and comparing two different prompt styles for the AI, where a simpler prompt actually gave better answers than an overly cautious one. Every question and search is also logged with detailed tracing, feeding a built in monitoring dashboard that shows request volume, response times, token usage, estimated cost, and user feedback collected as thumbs up or down on each answer. Running the project locally requires a Python package manager called uv, plus Ollama for running the underlying language model, and involves downloading models, fetching the release data, building the search indexes, and starting a chat interface built with Streamlit. Docker Compose is also supported as an alternative way to run the whole system, including the scheduled weekly refresh job.

prompts (copy fr)

prompt 1
Help me set up DevPulse locally with uv and Ollama and run the ingestion pipeline.
prompt 2
Explain how DevPulse combines text search and vector search with reranking to find release notes.
prompt 3
Walk me through the evaluation results comparing retrieval methods in evaluation/results.md.
prompt 4
Show me how to add an eleventh project's release notes to DevPulse's knowledge base.

Frequently asked questions

what is dev-pulse fr?

An AI agent that answers plain-English questions about software release notes, citing the exact version behind each fact, refreshed weekly.

What language is dev-pulse written in?

Mainly Python. The stack also includes Python, Ollama, Pydantic AI.

How hard is dev-pulse to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is dev-pulse for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.