Memory Create-Batch

goodmem memory create-batch

Create multiple memories from a directory of files

Synopsis

Create multiple memories in a single operation by reading files from a directory.

Files are uploaded in batches with a maximum of 20 files or 5MB of content per request, whichever is reached first. A Bubble Tea TUI renders client-side progress (discovered, batched, uploaded) alongside server-side processing status (pending, processing, completed, failed).

goodmem memory create-batch [flags]

Examples

  # Upload all files in ./notes to a space with 4 concurrent uploads
  goodmem memory create-batch --space-id 123e4567-e89b-12d3-a456-426614174000 --dir ./notes --parallel 4

  # Preview the batches without uploading
  goodmem memory create-batch --space-id 123e4567-e89b-12d3-a456-426614174000 --dir ./docs --dry-run

  # Disable page-image extraction for the batch
  goodmem memory create-batch --space-id 123e4567-e89b-12d3-a456-426614174000 --dir ./archive --no-extract-page-images

  # Log results to a file while limiting to 200 files
  goodmem memory create-batch --space-id 123e4567-e89b-12d3-a456-426614174000 --dir ./archive \ 
    --max-files 200 --log-file upload.log

Options

      --chunk-overlap uint32     Overlap between chunks (characters or tokens) (default 64)
      --chunk-size uint32        Maximum chunk size (characters or tokens) (default 512)
      --chunking string          Chunking strategy: none, recursive, sentence (default "recursive")
      --chunking-help            Show chunking strategies and detailed help
      --dir string               Directory containing files to upload
      --dry-run                  Preview batches without uploading any content
      --extract-page-images      Request page-image extraction for eligible documents in each upload (enabled by default)
  -h, --help                     help for create-batch
      --keep-separator string    Separator retention: start, end (default "end")
      --length-unit string       Length measurement unit: chars, tokens (default "chars")
      --log-file string          Write upload results to the specified log file
      --max-files int            Maximum number of files to process (0 for no limit)
      --no-extract-page-images   Disable page-image extraction for this batch upload
      --no-follow                Do not poll server-side processing status after uploads finish
      --parallel int             Number of concurrent batch uploads (default 4)
      --separator strings        Custom separators (defaults: \\n\\n, \\n, space, empty string)
      --separator-regex          Treat separators as regex patterns
      --space-id string          ID of the space to create memories in

Options inherited from parent commands

      --api-key string   API key for authentication (can also be set via GOODMEM_API_KEY environment variable)
      --server string    GoodMem server address (gRPC API)