botstash 0.1.0

CLI tool and WebUI that ingests LMS course exports and Echo360 transcripts into an AnythingLLM workspace for embedded course chatbots.

BotStash

A CLI tool and lightweight WebUI that ingests LMS course exports (Blackboard IMSCC / Canvas) and Echo360 VTT transcripts, uploads content to an AnythingLLM workspace, and returns embeddable chatbot code for pasting into a course page.

Features

• IMSCC ingestion — unzips and walks Blackboard/Canvas common cartridge exports
• Transcript ingestion — processes folders of Echo360 VTT files
• Multi-format extraction — PPTX, DOCX, PDF, VTT, QTI quizzes
• Auto-classification — heuristic tagging of content types (lecture, worksheet, assignment, etc.)
• AnythingLLM integration — uploads documents, manages workspaces, retrieves embed code
• WebUI — FastAPI + Jinja2 interface for non-terminal users

Installation

pip install botstash

Quick Start

# Full pipeline
botstash run course.zip transcripts/ \
  --workspace ISYS2001 \
  --url https://your-anythingllm.instance \
  --key YOUR_API_KEY

# Two-step workflow (extract, review, embed)
botstash extract course.zip transcripts/ --output ./staging/
# ... review staging/tags.json ...
botstash embed ./staging/ --workspace ISYS2001

# Launch WebUI
botstash serve

Development

# Clone and install in dev mode
git clone https://github.com/michael-borck/botstash.git
cd botstash
uv sync --dev

# Run checks
uv run ruff check src/ tests/
uv run mypy src/
uv run pytest

License

MIT