8000 GitHub - qsrahman/wikibot: CLI/Web UI chatbot that answers questions from English Wikipedia, using the OpenAI Responses API with Wikipedia search/read tools. · GitHub
[go: up one dir, main page]

Skip to content
qsrahmanPublic

About

CLI/Web UI chatbot that answers questions from English Wikipedia, using the OpenAI Responses API with Wikipedia search/read tools.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

31 Commits

Folders and files

Repository files navigation

wikibot

A Wikipedia chatbot with two frontends — a REPL and a Gradio web app — over the same OpenAI Responses API agent with Wikipedia search/read tools.

Setup

Requires uv.

  1. Fill in .env:

    OPENAI_API_KEY=sk-...
    OPENAI_MODEL=gpt-4o-mini
    OPENAI_BASE_URL=            # optional, any OpenAI-compatible endpoint
    
  2. Run:

    uv run --env-file .env -m wikibot

REPL

$ uv run --env-file .env -m wikibot
wikibot — answers from English Wikipedia.
commands: exit | quit | .reset (clear history)
> Who was Alan Turing?
  -> search_wikipedia({"query": "Alan Turing", "limit": 5})
  -> get_page_summary({"title": "Alan Turing"})

Alan Mathison Turing (23 June 1912 – 7 June 1954) was an English
mathematician, logician and cryptanalyst, widely regarded as the
father of theoretical computer science.

Source: [Alan Turing](https://en.wikipedia.org/wiki/Alan_Turing)
> 

Tool calls print as they happen; the answer is then streamed in live. Commands: exit / quit to leave, .reset to clear conversation history.

Web UI

uv run --env-file .env python -m wikibot.webui

Opens a Gradio chat app on http://localhost:7860 with:

  • centered-column layout — a chat list on the left and one reading column; your question in a pill on the right, the answer as plain text
  • several chats — New chat starts one, the list switches between them, Delete this chat removes the open one; listed under Today, Yesterday and Earlier by when they were last used
  • Try again — the button under the last answer asks that question 5A88 afresh
  • streaming answers — live tokens; the input is locked while the agent works
  • lookup steps — each answer's tool calls fold into one line such as "Searched Wikipedia and read 1 article"; click it for the details
  • citations as clickable links that open in a new tab
  • persistent chats across reloads (localStorage); an answer cut off by a closed tab is marked "Lookup interrupted" and the chat stays usable
  • on a phone-width screen the chat list becomes a strip across the top
  • copy buttons and friendly error bubbles

Same backend as the CLI — wikibot/agent.py + wikibot/wiki.py are shared.

Layout

File Purpose
wikibot/wiki.py Wikipedia adapter over wikipediaapi (search, summary, content, sections, links, random pages)
wikibot/agent.py Tool schemas + Responses API agent loop (run_turn events)
wikibot/cli.py REPL
wikibot/webui.py Gradio web UI
wikibot/config.py Shared .env loading for both entrypoints

Wikipedia access is free and keyless (MediaWiki Action API); only the OpenAI key is required. Set a contact address in the User-Agent if you run this at scale — see wikibot/wiki.py (USER_AGENT).

About

CLI/Web UI chatbot that answers questions from English Wikipedia, using the OpenAI Responses API with Wikipedia search/read tools.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0