botstash 0.1.0__py3-none-any.whl

botstash/__init__.py

@@ -0,0 +1,3 @@
+"""BotStash — LMS course content to AnythingLLM chatbot pipeline."""
+
+__version__ = "0.1.0"

botstash/anythingllm/client.py

@@ -0,0 +1 @@
+"""AnythingLLM REST API wrapper."""

botstash/classifier/auto.py

@@ -0,0 +1 @@
+"""Heuristic and optional AI classification."""

botstash/cli.py

@@ -0,0 +1,70 @@
+"""Click-based CLI entry points."""
+
+import click
+
+from botstash import __version__
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="botstash")
+def cli() -> None:
+    """BotStash — LMS course content to AnythingLLM chatbot pipeline."""
+
+
+@cli.command()
+@click.argument("course_zip", type=click.Path(exists=True))
+@click.argument("transcripts", type=click.Path(exists=True))
+@click.option("--workspace", required=True, help="AnythingLLM workspace name.")
+@click.option("--url", envvar="ANYTHINGLLM_URL", help="AnythingLLM instance URL.")
+@click.option("--key", envvar="ANYTHINGLLM_KEY", help="AnythingLLM API key.")
+@click.option("--keep-staging", is_flag=True, help="Keep staging files after embed.")
+def run(
+    course_zip: str,
+    transcripts: str,
+    workspace: str,
+    url: str | None,
+    key: str | None,
+    keep_staging: bool,
+) -> None:
+    """Run the full extract-classify-embed pipeline."""
+    click.echo("botstash run: not yet implemented")
+
+
+@cli.command()
+@click.argument("course_zip", type=click.Path(exists=True))
+@click.argument("transcripts", type=click.Path(exists=True))
+@click.option("--output", default="./staging", help="Output directory.")
+def extract(course_zip: str, transcripts: str, output: str) -> None:
+    """Extract and auto-classify content from a course export."""
+    click.echo("botstash extract: not yet implemented")
+
+
+@cli.command()
+@click.argument("staging_dir", type=click.Path(exists=True))
+@click.option("--workspace", required=True, help="AnythingLLM workspace name.")
+@click.option("--tags", type=click.Path(exists=True), help="Path to tags.json.")
+@click.option("--reset", is_flag=True, help="Clear workspace before uploading.")
+def embed(staging_dir: str, workspace: str, tags: str | None, reset: bool) -> None:
+    """Embed staged documents into an AnythingLLM workspace."""
+    click.echo("botstash embed: not yet implemented")
+
+
+@cli.command()
+@click.argument("workspace")
+def chatbot(workspace: str) -> None:
+    """Retrieve the chatbot embed code for a workspace."""
+    click.echo("botstash chatbot: not yet implemented")
+
+
+@cli.command()
+def init() -> None:
+    """Scaffold a .botstash.env configuration file."""
+    click.echo("botstash init: not yet implemented")
+
+
+@cli.command()
+@click.option("--host", default="127.0.0.1", help="Host to bind to.")
+@click.option("--port", default=8000, help="Port to bind to.")
+def serve(host: str, port: int) -> None:
+    """Launch the BotStash WebUI."""
+    click.echo("botstash serve: not yet implemented")

botstash/config.py

@@ -0,0 +1 @@
+"""Configuration file and environment variable handling."""

botstash/extractors/docx.py

@@ -0,0 +1 @@
+"""DOCX text extraction."""

botstash/extractors/pdf.py

@@ -0,0 +1 @@
+"""PDF text extraction."""

botstash/extractors/pptx.py

@@ -0,0 +1 @@
+"""PPTX text extraction."""

botstash/extractors/qti.py

@@ -0,0 +1 @@
+"""QTI XML quiz extraction — question text only."""

botstash/extractors/unit_outline.py

@@ -0,0 +1 @@
+"""Bespoke unit outline extraction plugin."""

botstash/extractors/url_tracker.py

@@ -0,0 +1 @@
+"""Log video/external URLs found in manifests."""

botstash/extractors/vtt.py

@@ -0,0 +1 @@
+"""VTT to clean text conversion (timestamps stripped)."""

botstash/ingester/imscc.py

@@ -0,0 +1 @@
+"""Unzip and walk IMSCC/common cartridge structure."""

botstash/ingester/transcript.py

@@ -0,0 +1 @@
+"""VTT folder ingestion."""

botstash/pipeline.py

@@ -0,0 +1 @@
+"""Orchestrates the full extract-classify-embed pipeline."""

botstash/webui/app.py

@@ -0,0 +1 @@
+"""FastAPI + Jinja2 WebUI."""

botstash-0.1.0.dist-info/METADATA

@@ -0,0 +1,86 @@
+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

botstash-0.1.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+botstash/__init__.py,sha256=WFQEtIGkRLYjgt77tfYhL9ylDCRdw0t0pRCF68p7C_A,94
+botstash/cli.py,sha256=60f1o2qgFQvJhjQ1EJs-t-tUUdlPAcv6xDdUEQz8mvg,2531
+botstash/config.py,sha256=jBGr_r_dXT1lu3OUmLynmr6VhHuhFzw135fcZHt5o_o,60
+botstash/pipeline.py,sha256=R_zLhAX-qm5n2Njez_ZqPZzcJ1r45a5eVlYsLJ61NlY,61
+botstash/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+botstash/anythingllm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+botstash/anythingllm/client.py,sha256=cwlD8Cr0m-vnG9ofxSD7bmltDe7L9Da6nVJFMdLG3a8,36
+botstash/classifier/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+botstash/classifier/auto.py,sha256=B93zDBsmhKlx7sv7aOUJkwLhsdkuKSpD_u7_YhhRCVU,48
+botstash/extractors/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+botstash/extractors/docx.py,sha256=phriXPLU1gtCfJKu9n5mOMUqfr9nwwS5_XU2Lcpn15Q,28
+botstash/extractors/pdf.py,sha256=tQdoOvmOes06V7xT_b4iM2_3QWL_L59q3O_3nx1S6co,27
+botstash/extractors/pptx.py,sha256=MuUn-z2G_qMM1uOnzvUuNoEmY9I8lmVxv8LBd2CcL3o,28
+botstash/extractors/qti.py,sha256=LFcLDMlbyOMMffI7_bJQMtuWBStJ6QVLCTTp8ZJUHh0,54
+botstash/extractors/unit_outline.py,sha256=hA3OESDnVDCs3BOazRu87aXhu6Mq5CJHmO1wBYf5-xs,46
+botstash/extractors/url_tracker.py,sha256=BOPCR03ba2fnQ6A6tujGLZ62Q90X5-uUxT-HzdqHoAk,50
+botstash/extractors/vtt.py,sha256=G5cTh72naIFbMvOXlCrwUePsvD2saSnlV6ZEmm89w_I,58
+botstash/ingester/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+botstash/ingester/imscc.py,sha256=0WAh4otJ9Hjkl1MdoE9JAG7sZBNAuUSZjvKmRPsQ6Z8,55
+botstash/ingester/transcript.py,sha256=rObH3amvhnrpFjPl-4WpJp1--1LWrIqlY0BItIDE7s8,28
+botstash/webui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+botstash/webui/app.py,sha256=WTDtns88pGoOXxpzd5o3nqVWun6c-87-HJMxZ8JEq9U,30
+botstash-0.1.0.dist-info/METADATA,sha256=cbTbEZDanf6F73SjdSSowO4EILA8MfytXZC0okHDXrY,2742
+botstash-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+botstash-0.1.0.dist-info/entry_points.txt,sha256=_-hTmjM8HqsoqtRuv4aEeOzClgzs_wB75TOaagSPmFU,46
+botstash-0.1.0.dist-info/licenses/LICENSE,sha256=0uVeJfLU3mjdYwRrEGRh4X0RQC0fbqX3Hc8BjSaZSJg,1064
+botstash-0.1.0.dist-info/RECORD,,

botstash-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

botstash-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+botstash = botstash.cli:cli

botstash-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.