Your First Node

Creating and understanding nodes in RA-H

What is a Node?

In RA-H, a node is the fundamental unit of knowledge. Unlike files in a folder system, nodes are:

  • Flexible: Can contain any type of content
  • Connected: Automatically linked to related nodes
  • Evolving: Gain dimensions and connections over time

Creating Your First Node

Using the UI

  1. Click [+ New Node] in the Nodes panel
  2. Enter a title in the Focus panel
  3. Add your content (markdown supported)
  4. Press Cmd+S or click Save
Use the UI during the beta. API/CLI examples will return later.

Node Structure

Every node contains:

interface Node {
  id: string           // unique identifier
  title: string        // human-readable title
  content: string      // markdown content
  dimensions: string[] // emergent tags
  embedding: number[]  // vector for similarity
  metadata: {
    created: Date
    modified: Date
    source?: string    // youtube, website, etc
    author?: string
  }
}

Content Types

Nodes can contain various content types:

Text Notes

# Meeting Notes
- Discussed emergent organization
- Non-prescriptive approaches win

Code Snippets

```python
def process_node(node):
    return embed(node.content)
```

Extracted Content

[Extracted from: https://example.com]
Article content here...

Automatic Features

When you create a node, RA-H automatically:

  1. Generates embeddings for semantic search
  2. Extracts dimensions from content
  3. Creates edges to related nodes
  4. Indexes for search across all helpers

Tips

  • Keep titles short and specific
  • Write naturally; dimensions and connections will emerge

Best Practices

Don't overthink structure - Let dimensions emerge naturally from your content rather than pre-defining categories.

  • Write naturally: Don't force keywords
  • Link freely: Mention other concepts naturally
  • Trust emergence: Organization will develop over time
  • Use helpers: Let AI assistants help you explore connections

Next Steps

Understanding dimensions
Using helpers to explore