Cart Builder

Drag-and-drop web app for building Membot brain cartridges from documents.

Quick Start

cd cart-builder
pip install flask pymupdf python-docx openpyxl striprtf sentence-transformers
python app.py

Open http://localhost:5000

What It Does

1. Upload documents (PDF, DOCX, XLSX, TXT, MD, RTF) via drag-and-drop or file browser
2. Preview extracted text and edit metadata (owner, description, tags) per file
3. Build a brain cartridge — embeds with Nomic, generates sign-zero signatures, packages as .cart.npz
4. Search the built cart right in the browser
5. Deploy the cart to a remote Membot server

Managing Carts

• My Carts panel with breadcrumb folder navigation
• Browse any folder on your machine — see subfolders, existing carts, and ingestable documents
• Open an existing cart to add new files, remove files, or replace documents, then rebuild
• Save multiple cart folder locations for quick access

Editing Existing Carts

Click Open on any cart in the My Carts panel. The cart's contents load as file cards. From there:

• Add more files via drag-and-drop or the folder browser's "+ Add to cart" button
• Remove a file (click x) — soft-removes with undo. Removed files are excluded from the next build.
• Replace a file — swaps the document but preserves metadata
• Click Update Cart to rebuild with your changes

Deploying

The Deploy button uploads the built cart to a remote Membot server. Default target is 137.184.227.79:8040 (writable endpoint with Bearer auth).

The server needs an /api/upload_cartridge route that accepts multipart form data.

File Structure

cart-builder/
  app.py              Flask backend
  parsers.py          Document text extraction (PDF, DOCX, XLSX, TXT, MD, RTF)
  builder.py          Embedding + sign-zero + cart packaging
  templates/
    index.html        Single-page app
  static/
    style.css         Dark mode UI
    app.js            Frontend logic
  settings.json       Saved cart folder paths
  uploads/            Temp storage for uploaded files
  built_carts/        Default output directory

Dependencies

• Flask
• PyMuPDF (PDF parsing)
• python-docx (DOCX parsing)
• openpyxl (XLSX parsing)
• striprtf (RTF parsing)
• sentence-transformers (Nomic embedding)
• requests (deploy to server)

Part of Project You

Cart Builder is the document ingestion frontend for Membot brain cartridges. Carts are portable, LLM-free, searchable knowledge files that any AI agent can use via MCP.