Metadata-Version: 2.4
Name: botstash
Version: 0.1.0
Summary: CLI tool and WebUI that ingests LMS course exports and Echo360 transcripts into an AnythingLLM workspace for embedded course chatbots.
Project-URL: Homepage, https://github.com/michael-borck/botstash
Project-URL: Repository, https://github.com/michael-borck/botstash
Project-URL: Issues, https://github.com/michael-borck/botstash/issues
Author-email: Michael <michael@example.com>
License-Expression: MIT
License-File: LICENSE
Keywords: anythingllm,botstash,chatbot,education,lms,rag
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Education
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: fastapi>=0.115
Requires-Dist: httpx>=0.27
Requires-Dist: jinja2>=3.1
Requires-Dist: pdfminer-six>=20231228
Requires-Dist: python-docx>=1.1
Requires-Dist: python-dotenv>=1.0
Requires-Dist: python-pptx>=1.0
Requires-Dist: uvicorn>=0.32
Requires-Dist: webvtt-py>=0.5
Description-Content-Type: text/markdown

# BotStash

A CLI tool and lightweight WebUI that ingests LMS course exports (Blackboard IMSCC / Canvas) and Echo360 VTT transcripts, uploads content to an [AnythingLLM](https://anythingllm.com/) 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

```bash
pip install botstash
```

## Quick Start

```bash
# 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

```bash
# 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
