Cogwit can connect to your local Cognee instance, allowing you to work with local data through the cloud interface and sync between environments.

​
Local Mode

Cogwit automatically detects and connects to local Cognee instances:
  • Connection Status: When connected, the “Local Cognee” section shows “Connected” in the UI
  • Full Functionality: Browse datasets, upload files, run cognify, and execute notebook cells against your local engine
  • Same Interface: All operations use the same UI whether working with local or cloud data
Local mode requires a running Cognee server on localhost:8000. Start your local server with cognee serve to enable local mode features.

​
Data Sync

Cogwit provides powerful sync capabilities for moving data between local and cloud environments:

​
Sync Features

  • Binary file handling — Upload and download files for data connectors
  • Hash-based synchronization — Only syncs files that have changed, reducing unnecessary transfers
  • Dataset-specific storage — Files are organized by dataset with proper isolation

​
How sync works

  1. Detect changes — Compare file hashes to identify what needs to be synchronized
  2. Upload changes — Transfer only modified files to the target environment
  3. Verify integrity — Confirm files are properly stored and accessible
  4. Update metadata — Sync dataset information and permissions
Sync is currently experiencing issues and is under construction. Some sync features may not work as expected. We’re working to resolve these problems and will update this documentation once sync is fully operational.

Cogwit architecture

Understand how Cogwit pipelines stay online once you migrate.

Permissions & Security

Map local user roles to Cogwit workspaces and dataset permissions.