KYBERNESIS
DOCUMENTATION
ACCESS_CONSOLE

Getting Started with Kybernesis

This guide will help you set up your Kybernesis account and start building your memory layer in minutes.

Table of Contents

Create Your Account

  1. Visit Kybernesis

    terminal
    https://kybernesis.ai

  2. Sign Up

    • Click "INIT_SESSION"
    • Enter your email and create a password
    • Verify your email address

  3. Start Using Kybernesis

    • You'll see the Topology view
    • This is your interactive memory graph where all your memories appear as connected nodes

Your First Memory

There are three ways to add memories to Kybernesis:

Method 1: Chat Input (Fastest)

  1. Press Cmd+K (or Ctrl+K on Windows) to open the chat input
  2. Type a message or paste some text:
    terminal
    Remember that the quarterly review meeting is scheduled for next Friday at 2pm
  3. Press Send
  4. You'll see a new node like this appear in the topology graph

Method 2: File Upload

  1. Find any PDF, text file, or document
  2. Drag and drop it onto the Topology canvas
  3. Wait a few seconds for processing
  4. The document appears as a new memory node

Supported formats:

  • PDF documents
  • Text files (.txt, .md)
  • Microsoft Office (.docx, .xlsx)
  • Code files (.js, .py, .ts, etc.)

Method 3: Connect External Sources

  1. Press Cmd+C (or Ctrl+C on Windows) to open the connectors modal
  2. Choose Google Drive or Notion
  3. Authorize Kybernesis to access your account
  4. Select which files/pages to sync
  5. Your memories will automatically sync in the background

See the Connectors Guide for detailed setup instructions.

Understanding the Topology

The Topology view is an interactive knowledge graph of your memories.

Reading the Graph

Nodes (circles):

  • Each node represents one memory
  • Size: Larger nodes have more connections
  • Color: Different sources have different colors
    • Green: Chat messages
    • Blue: Uploaded documents
    • Yellow: Google Drive files
    • Purple: Notion pages

Edges (lines):

  • Connections between related memories
  • Thickness: Stronger relationships are thicker
  • Style:
    • Solid: Strong connection
    • Dashed: Medium connection
    • Dotted: Weak connection

Interacting with Nodes

Click a node to view:

  • Full content
  • Tags
  • Source information
  • Option to delete

The graph automatically organizes itself:

  • Related memories stay close together
  • The graph uses physics to create natural clusters
  • New memories automatically connect to related ones

Finding Your Memories

Your memories are always visible in the Topology graph. To find a specific memory:

  1. Look for nodes that match what you're looking for
  2. Click on a node to view its full content
  3. Use the visual layout - related memories appear close together
  4. Follow the connections between nodes to discover related information

Next Steps

Now that you have memories in Kybernesis:

1. Add More Memories

  • Upload your existing documents
  • Use the chat input for notes and ideas
  • Connect Google Drive or Notion (press Cmd+C)
  • Drag and drop multiple files at once

2. Explore the Graph

  • Click on nodes to read your memories
  • Notice how related memories connect to each other
  • Drag nodes to organize your view
  • Watch as new memories automatically connect to related ones

3. For Developers: Set Up MCP

If you use Claude Desktop or other AI tools that support MCP (Model Context Protocol):

  • See the MCP Setup Guide
  • Your AI can access all your memories through a simple API

How Kybernesis Works Behind the Scenes

Kybernesis automatically:

  • Connects related memories based on their content
  • Organizes memories for fast access
  • Keeps your most important and frequently accessed memories readily available

You don't need to manage any of this - it all happens automatically.

Common Questions

How much can I store?

Unlimited memories. The system is designed to handle any amount of content you throw at it.

How do memories connect to each other?

Kybernesis automatically finds relationships between your memories based on their content, creating connections you can see in the topology graph.

Can I delete memories?

Yes. Click any node and click DELETE. This is permanent and cannot be undone.

What happens to my uploaded files?

Your files are processed and stored securely. The original files and their content remain private to your account.

Troubleshooting

Upload Not Processing

  • Very large files (> 50MB) may take a few minutes to process
  • Make sure the file format is supported
  • Try refreshing the page

Topology Graph is Blank

  • Make sure you're logged in
  • Add some memories first - the graph only shows memories you've created
  • Try refreshing the page if you just added something

What's Next?

Now that you understand the basics:

  • Core Concepts - Learn more about how Kybernesis works
  • Connectors Guide - Set up Google Drive and Notion sync
  • UI Guide - Tips and tricks for using the topology
  • MCP Setup - Connect Claude Desktop or other AI tools (for developers)

Need help? Check the Documentation for more guides.