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

  # 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
  -h, --help                    help for create-batch
      --keep-separator string   Separator retention: none, 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-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) (default "https://localhost:9090")