Arbour

The Neuro-Symbolic ChatOps Assistant.

Connect your Knowledge Base (Markdown) to your Instant Messenger (WhatsApp).

Arbour is a Host Application that bridges the gap between conversational interfaces and deterministic logic. It uses Trellis as its brain and Loam as its memory.

It works with any directory of Markdown, YAML, or JSON files. We recommend Obsidian for the best editing experience.

---

🏗 Architecture

Arbour follows a Library/Framework hybrid architecture:

graph TD
    User((User)) <-->|WhatsApp| Host[Arbour Daemon]
    
    subgraph "Arbour Core"
        Host -->|Inputs| Trellis[Trellis Engine]
        Trellis -->|Load Flows| Loam[Loam Repository]
    end
    
    Loam <-->|Read| Vault[Obsidian Vault]

Loading

• Arbour: The "Body" (The Shelter). Handles connection (WhatsApp), signals, and execution.
• Trellis: The "Brain" (The Structure). A deterministic state machine that decides what to do next.
• Loam: The "Memory" (The Soil). Adapts your local filesystem (Markdown/YAML) into structured data.

🚀 Quick Start

1. Installation

go install github.com/aretw0/arbour@latest

2. Run the Daemon

Point Arbour to your Obsidian Vault (or any folder with Trellis flows):

arbour start --dir ./my-notes

Scan the QR Code with WhatsApp, and you are ready.

🛠 Development

Run Locally

go run ./cmd/arbour start --dir ./examples/hello

Roadmap

Check docs/PLANNING.md for the active roadmap.

📚 Documentation

• Product Vision
• Technical Architecture