Files
notedeck/crates/notedeck_dave
2025-04-30 08:49:22 -07:00
..
2025-04-21 12:48:33 -07:00
2025-04-22 18:42:12 -07:00
2025-04-18 17:03:59 -07:00
2025-04-30 08:49:22 -07:00

Dave - The Nostr AI Assistant

Dave is an AI-powered assistant for the Nostr protocol, built as a Notedeck application. It provides a conversational interface that can search, analyze, and present Nostr notes to users.

Overview

Dave demonstrates how to build a feature-rich application on the Notedeck platform that interacts with Nostr content. It serves both as a useful tool for Nostr users and as a reference implementation for developers building Notedeck apps.

Features

  • Interactive 3D avatar with WebGPU rendering
  • Natural language conversations with AI
  • Query and search the local Nostr database for notes
  • Present and render notes to the user
  • Tool-based architecture for AI actions
  • Context-aware searching (home, profile, or global scope)
  • Chat history persistence
  • Anonymous lmzap backend

Technical Details

Dave uses:

  • Egui for UI rendering
  • WebGPU for 3D avatar visualization
  • OpenAI API (or Ollama with compatible models)
  • NostrDB for efficient note storage and querying
  • Async Rust for non-blocking API interactions

Architecture

Dave is structured around several key components:

  1. UI Layer - Handles rendering and user interactions
  2. Avatar - 3D representation with WebGPU rendering
  3. AI Client - Connects to language models via OpenAI or Ollama
  4. Tools System - Provides structured ways for the AI to interact with Nostr data
  5. Message Handler - Manages conversation state and message processing

Usage as a Reference

Dave serves as an excellent reference for developers looking to:

  • Build conversational interfaces in Notedeck
  • Implement 3D rendering with WebGPU in Rust applications
  • Create tool-based AI agents that can take actions in response to user requests
  • Query and present Nostr content in custom applications

Getting Started

  1. Clone the repository
  2. Set up your API keys for OpenAI or configure Ollama
    export OPENAI_API_KEY=your_api_key_here
    # or for Ollama
    export OLLAMA_HOST=http://localhost:11434
    
  3. Build and run the Notedeck application with Dave

Configuration

Dave can be configured to use different AI backends:

  • OpenAI API (default) - Set the OPENAI_API_KEY environment variable
  • Ollama - Use a compatible model like hhao/qwen2.5-coder-tools and set the OLLAMA_HOST environment variable

Contributing

Contributions are welcome! See the issues list for planned features and improvements.

License

GPL

  • nostrdb - Embedded database for Nostr notes