Model or dataset
melih-unsal/DemoGPT avatar
melih-unsal/DemoGPT

DemoGPT: Prompt-to-LangChain Pipeline Generation Plus an Agent Library

🤖 Create agentic apps in a second with your prompts. Everything you need to create an LLM Agent - tools, prompts, frameworks, and models - all in one place.

1,908 stars219 forksPythonMIT

At a glance

What is it?
DemoGPT combines a generator that turns a prompt into a LangChain pipeline with AgentHub, a separate library of tools, agents and RAG. The two halves have different maturity levels, and the README treats them as one product.
Who is it for?
Adopt DemoGPT if you want to sketch a LangChain pipeline from a prompt without hand-writing the chain, or if you need a small set of prebuilt tools (Tavily search, weather, Wikipedia, Bash, Python, Arxiv and others) wired into a ToolCallingAgent. Do not adopt it if you need a stable, versioned agent platform: the latest release listed is v1.2.6 from September 2023, and the AgentHub API is documented only through README snippets.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Activity is slowing. The repository last received commits 7 months ago.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • melih-unsal/DemoGPT1,908 ★ · +0
Star history
Repository2026-09-122026-11-15
melih-unsal/DemoGPT1.9k1.9k

0 Stars in the last 64 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

The gap DemoGPT tries to close between a prompt and a working chain

Writing a LangChain pipeline by hand means choosing a model, picking tools, wiring prompts together and getting the output parser right. DemoGPT's stated purpose is to generate that pipeline from a prompt instead. The repository description puts it as creating agentic apps in a second from your prompts, and the README frames the project as a place where tools, prompts, frameworks and a knowledge hub of LLM models sit together. The audience is developers who already know roughly what they want an agent to do but do not want to assemble the scaffolding first. The second half of the project, AgentHub, targets a narrower need: a ready set of tools and agent classes you can import rather than write from scratch. Those two goals are related but not identical, and the README presents them under one banner.

What the README actually shows about the mechanism

What is visible is the AgentHub side. A tool subclasses BaseTool, sets a name and a description in __init__, calls super().__init__(), and implements run(self, query). The agent receives the tool objects plus an LLM instance, and when run is called the agent produces a reasoning block, a tool call, a tool result and a final answer. The example output in the README shows exactly that sequence for a custom tool. Descriptions matter here: the sample reasoning text cites the tool's own description as the reason for selecting it, which is how the tool-calling loop decides what to invoke. Built-in tools listed include TavilySearchTool, WeatherTool, WikipediaTool, BashTool, PythonTool, ArxivTool, YouTubeSearchTool, StackOverFlowTool, RequestUrlTool, WikiDataTool and PubmedTool. RAG appears as a tool in the agent's decision output, and the README documents combining RAG with agents as a separate topic.

Installing and running the documented examples

The README gives one installation command for the whole package: pip install demogpt. Tool creation is a plain Python class, imported as from demogpt_agenthub.tools import BaseTool. Building an agent uses from demogpt_agenthub.agents import ToolCallingAgent, from demogpt_agenthub.llms import OpenAIChatModel, and from demogpt_agenthub.tools import TavilySearchTool, WeatherTool. The model is constructed with a model name string, shown as OpenAIChatModel(model_name="gpt-4o-mini"), and the agent takes tools, llm and a verbose flag. Invocation is agent.run(query). The README also mentions a Python interface and a source code version under its usage section, and links a Streamlit app and a Hugging Face Space for a hosted demo. What it does not give is a pinned version, a requirements file, or a note on which Python versions are supported. If you need reproducibility, that absence is the first thing you will have to solve yourself.

The release history and the AgentHub documentation problem

The most recent release listed is v1.2.6, dated 2023-09-28. The two before it are v1.2.5 and v1.2.4, both from 2023. The repository's last push is dated 2026-04-01, which means commits have landed more recently than the last tagged release. That gap matters for adoption: if you install from PyPI you get whatever corresponds to the published release, and if you install from source you get the main branch, which is not the same artifact. The README documents AgentHub entirely through snippets. The example output also includes a line about removing an existing vectorstore at rag_chroma, which appears in a weather question example and looks like leftover output from a different run. Treat the printed outputs as illustrative rather than as guarantees about what your run will print.

Where DemoGPT is the wrong tool

The design assumes a tool-calling loop driven by an LLM that reads tool descriptions and decides what to call. That is a poor fit when you need deterministic execution. A BashTool and a PythonTool in the same registry mean the agent can, in principle, select either for a task, and the README's own example shows the model narrating its choice in a reasoning block. If your workflow requires an auditable, fixed sequence of steps, a generated pipeline you did not write is harder to reason about than a chain you did. There is also a provider constraint: the documented LLM class is OpenAIChatModel, and while the topics list mentions Gemini and Qwen, the README's code samples use the OpenAI path. Anyone standardised on a different provider should confirm support before planning around it. Finally, the release cadence suggests the tagged artifacts are old, so a team that pins dependencies to releases may be pinning to 2023 code.

How this differs from using LangChain directly

LangChain, which DemoGPT builds on and lists among its topics, gives you the primitives: chains, tools, agents and retrievers, assembled by you. DemoGPT's difference is the generation layer on top, turning a prompt into a pipeline, plus a curated tool set behind demogpt_agenthub. The trade is control for speed. With LangChain alone you write the chain and know every step; with DemoGPT you describe the outcome and inspect what comes back. That is a reasonable trade for prototypes and internal demos, which the project name itself signals. It is a worse trade for production systems where you need to explain why a particular tool was called. The other practical difference is surface area: DemoGPT's AgentHub is a thin layer, so if it does not cover your provider or tool, you are back to LangChain anyway, having added a dependency.

Licence and the cost of keeping up

DemoGPT is MIT licensed, which permits commercial use, modification and redistribution provided the copyright notice and permission notice are retained. That is permissive and low friction for most teams; it is not legal advice, so have your own counsel review if the deployment matters. The maintenance cost is less comfortable. Because the last tagged release predates the last push by a wide margin, you have two upgrade paths and neither is clean: pin to a release and forgo later fixes, or track main and accept an untagged moving target. For a prototype this is tolerable. For anything with an SLA, budget time to vendor the code or fork it.

Editorial conclusion

Adopt DemoGPT if you want to sketch a LangChain pipeline from a prompt without hand-writing the chain, or if you need a small set of prebuilt tools (Tavily search, weather, Wikipedia, Bash, Python, Arxiv and others) wired into a ToolCallingAgent. Do not adopt it if you need a stable, versioned agent platform: the latest release listed is v1.2.6 from September 2023, and the AgentHub API is documented only through README snippets. Before committing, verify that the pip package version you install actually contains demogpt_agenthub, check whether your target LLM provider is among the ones the README names, and run one trivial agent against a tool you control.

Frequently asked questions

How do I install DemoGPT and what do I get?

Run pip install demogpt. The package ships two import roots, demogpt and demogpt_agenthub, and registers a console command named demogpt bound to demogpt.cli:main. The declared Python floor is 3.8.1.

Which tools does DemoGPT AgentHub ship with?

Eleven: TavilySearchTool, WeatherTool, WikipediaTool, BashTool, PythonTool, ArxivTool, YouTubeSearchTool, StackOverFlowTool, RequestUrlTool, WikiDataTool and PubmedTool. Three of them, BashTool, PythonTool and RequestUrlTool, run commands, execute code and fetch arbitrary URLs.

How do I add my own tool to a DemoGPT agent?

Subclass BaseTool, set self.name and self.description, call super().__init__(), and implement a run method. Then pass an instance in the tools list when you build the agent, for example ToolCallingAgent(tools=[my_tool], llm=llm, verbose=True).

What agent types does DemoGPT provide?

ToolCallingAgent, which prints a reasoning paragraph, the tool call, the tool result and the final answer, and ReactAgent, described as giving a more detailed reasoning process and shown emitting a Decision line. Both take a tools list, a model and a verbosity flag.

What version of DemoGPT is current?

The project file declares 1.3.6, while the newest GitHub release is v1.2.6 published 2023-09-28. The last commit to the repository is 2026-04-01, so the source has moved on without a new tag.

What happens to my vector store when a DemoGPT RAG agent runs?

The sample output's first line is Removing existing vectorstore at rag_chroma, so the retrieval step removes the existing store before answering, and the page names no flag to prevent it. The store is Chroma, reached through langchain-chroma.

Official sources

  1. Issues
  2. License: MIT
  3. melih-unsal/DemoGPT on GitHub
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/melih-unsal-demogpt.svg)](https://hysenlabs.com/projects/melih-unsal-demogpt)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/melih-unsal-demogpt.svg)](https://hysenlabs.com/projects/melih-unsal-demogpt)

Was this useful?