00 Local File Store Session

ComfyUI-ZMongo's whole pitch is "your workflow state lives in a database, not in hardcoded graph values." But that pitch usually starts with you handing an API key to someone else's server. This node is the escape hatch: Local File Store Session gives you the same ZMONGO_API_SESSION socket every other ZMongo node expects, backed by plain JSON on your own disk, with zero accounts, zero keys, zero network.

It's the right first node to add from this pack if you aren't sure you want their hosted service. Plug this in, wire its session output into a few 08/03/04 nodes, and you get persistent preset, document, and image storage that survives a restart. The upgrade path later is just swapping this for the API Key Session node - downstream wiring doesn't change, because both emit the same session type.

How it works

Under the hood it builds a ZMongoLocalFileStoreSession, which wraps the pack's LocalFileStore. This is deliberately not local MongoDB - the source is explicit about that. It writes JSON documents and image files to disk while preserving the things that matter: collections, document IDs, dot-path values, and image fields. If you leave local_store_root blank, data lands in nodes/local_store/ inside the custom node folder itself, which is worth knowing when you back up or wipe your ComfyUI directory.

The test_health toggle, on by default, runs a quick health() check at connect and reports it through the status output. Flip it off if you'd rather not pay even that trivial call, or if you want the connect to return the "who am I" style payload instead.

Inputs and outputs that matter

There are only two inputs:

• local_store_root - where to put the store. Blank = nodes/local_store.
• test_health - run the health check on connect.

And the outputs are the point:

• session - the ZMONGO_API_SESSION you wire into every other ZMongo node.
• json / status - human-readable confirmation of what got created.

Installing it

This is a pack-level install, so the steps are the same for every ZMongo node:

cd ComfyUI/custom_nodes
git clone https://github.com/CentralFloridaAttorney/ComfyUI-ZMongo

Then restart ComfyUI. ComfyUI Manager works too - search for "ComfyUI-ZMongo" and install from there. Note the shipped requirements.txt is heavy for a node pack: pymongo, motor, langchain, sentence-transformers, FlagEmbedding, transformers, and pymilvus all come along even if you only want the local store, so budget for a long first install.

Where people get burned

The big one: local-only mode can't do the Gemini text-agent stuff. The 10-series text agent nodes call the hosted backend's /api/chat endpoint through the session, and the Local File Store session doesn't serve that route. If a workflow asks you to wire a Text Agent Session node, you need the API Key Session (hosted account) instead - the local store is for presets, docs, values, and images, not LLM calls.

Also worth saying plainly: this pack has almost no community footprint - search the usual subreddits for "ZMongo" and you get nothing. Custom nodes run arbitrary Python with your user permissions, and this one is designed to talk to a remote service, so only install it if you're comfortable reading what it does. Keep your ComfyUI off the public internet regardless. The local store is your safest sandbox for playing with the pack before you decide whether the hosted backend is worth it.