Skip to content

README.md

Latest commit

 

History

History
87 lines (66 loc) · 2.58 KB

README.md

File metadata and controls

87 lines (66 loc) · 2.58 KB
domain
tags
chatbot
memory
gradio
oceanbase
datasets
evaluation test train
models
license Apache License 2.0

Endless Context

A lightweight Gradio chat agent with tape-first context management powered by Bub, SeekDB, and OceanBase. Built to be ModelScope-friendly while staying easy to run locally.

It provides:

  • a gradio Bub channel for browser chat
  • OceanBase/seekdb dialect registration compatible with bub-tapestore-sqlalchemy
  • a ModelScope-friendly app.py that boots Bub's ChannelManager with gradio enabled
  • the original three-pane Gradio UI/UX for tape, conversation, and anchors

The old private AppRuntime, custom tape store, and monkey patches inside the app layer have been removed.

Run on ModelScope Docker Studio

  1. Keep the provided Dockerfile and docker/entrypoint.sh.
  2. Exposed ports: 7860 (Gradio) and 2881 (SeekDB). Entry file is app.py.
  3. Set environment secrets in Studio, e.g. BUB_MODEL, BUB_API_KEY, BUB_API_BASE, BUB_TAPESTORE_SQLALCHEMY_URL, and the OCEANBASE_* values required by your seekdb deployment.
  4. Build and run. app.py starts Bub's channel manager with gradio enabled, so opening the forwarded 7860 port reaches the Bub channel directly.

Run locally (preferred: Docker)

Docker Compose (app + SeekDB)

cp .env.example .env   # fill in keys
make compose-up        # builds and starts everything

The UI is at http://localhost:7860. In Compose mode, SeekDB is only exposed on the internal Docker network so local port conflicts on 2881 do not block startup. Stop with make compose-down.

Single container

docker build -t endless-context:latest .
docker run --rm -p 7860:7860 -p 2881:2881 endless-context:latest

Bare-metal (advanced, no containers)

uv sync
cp .env.example .env
make run

Bub CLI shape

app.py starts the same shape you would get from:

uv run bub gateway --enable-channel gradio

That keeps the runtime aligned with Bub's extension model instead of a project-local forked runtime.

Docs

  • docs/index.md contains architecture, local/Docker workflows, and configuration details.

License

Apache License 2.0

Related