Relay16 - Nostr Social Client with AI Integration

Relay16 is a modern Nostr social client that integrates AI-powered tools through DVMCP (Data Vending Machine Context Protocol) for enhanced social media experiences.

✅ Status: Ready to Run

The application has been successfully set up and is ready for development. All major dependencies have been installed and configuration issues have been resolved.

Features

🌐 Nostr Protocol Support

• Multi-relay connections - Connect to multiple Nostr relays simultaneously
• Real-time feed - Live updates from the Nostr network
• Profile management - Create and edit your Nostr identity
• Note publishing - Compose and publish notes with rich formatting
• Social interactions - Like, reply, and repost notes

🤖 AI-Powered Features

• Thread summarization - AI-powered summaries of long conversations
• Writing assistance - Get AI suggestions for improving your posts
• Content analysis - Sentiment analysis and topic extraction
• Smart hashtag generation - AI-generated relevant hashtags

🔧 DVMCP Integration

• Tool discovery - Automatically discover available AI tools
• Provider management - Connect to multiple DVMCP providers
• Request tracking - Monitor AI tool usage and results
• Extensible architecture - Easy integration of new AI services

🎨 Modern UI/UX

• Responsive design - Works on desktop and mobile devices
• Dark/light themes - Automatic theme switching
• Smooth animations - Framer Motion powered transitions
• Component library - Built with HeroUI and shadcn/ui

Technology Stack

• Frontend: React 18 + TypeScript
• Styling: Tailwind CSS + HeroUI + shadcn/ui + tailwindcss-animate
• Animations: Framer Motion
• State Management: Zustand
• Nostr Protocol: nostr-tools (SimplePool API)
• AI Services: OpenRouter API
• Storage: Local Storage with Zustand persistence
• Build Tool: Vite

Getting Started

Prerequisites

• Node.js 18+
• npm or yarn

Installation

1. Clone the repository:

git clone <repository-url>
cd relay16

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

4. Open your browser and navigate to http://localhost:3000

Recent Fixes Applied

Configuration

Nostr Setup

1. Go to Settings → Identity
2. Generate new keys or import existing private key
3. Add Nostr relays in Settings → Relays

AI Services Setup

1. Get an API key from OpenRouter
2. Go to Settings → AI Services
3. Enter your OpenRouter API key

Project Structure

src/
├── components/          # Reusable UI components
│   ├── Layout.tsx      # Main app layout
│   └── ui/             # shadcn/ui components
├── pages/              # Main application pages
│   ├── Feed.tsx        # Social feed ✅
│   ├── Profile.tsx     # User profiles (needs fixes)
│   ├── Compose.tsx     # Note composition ✅
│   ├── Tools.tsx       # AI tools interface (needs fixes)
│   └── Settings.tsx    # App settings (needs fixes)
├── hooks/              # Custom React hooks
│   ├── useNostr.ts     # Nostr protocol integration ✅
│   └── useDVMCP.ts     # DVMCP tool integration ✅
├── stores/             # Zustand state stores
│   ├── nostr.ts        # Nostr state management ✅
│   ├── dvmcp.ts        # DVMCP state management ✅
│   └── ai.ts           # AI services state ✅
├── services/           # External service integrations
│   └── ai.ts           # OpenRouter AI service ✅
├── types/              # TypeScript type definitions
│   ├── nostr.ts        # Nostr protocol types ✅
│   ├── dvmcp.ts        # DVMCP types ✅
│   └── ai.ts           # AI service types ✅
├── lib/                # Utility functions
│   └── utils.ts        # Common utilities ✅
└── App.tsx             # Main application component ✅

Development Status

✅ Completed & Working

• Basic project setup and configuration
• Dependency management and build system
• Core TypeScript types and interfaces
• Nostr protocol integration with SimplePool
• AI service integration foundation
• Basic UI components and layout
• Feed and Compose pages

🔧 Needs Additional Work

• Profile page (missing some hook methods)
• Tools page (DVMCP store property mapping)
• Settings page (some missing store properties)
• Complete DVMCP provider integration
• Advanced Nostr features (DMs, follows)

Available Scripts

• npm run dev - Start development server ✅
• npm run build - Build for production
• npm run preview - Preview production build
• npm run lint - Run ESLint
• npm run type-check - Run TypeScript type checking

Next Steps for Development

1. Complete Missing Store Properties: Add missing properties to stores for Profile, Tools, and Settings pages
2. Implement Real DVMCP Integration: Replace mock data with actual DVMCP provider discovery
3. Add Advanced Nostr Features: Implement DMs, follows, and advanced relay management
4. Enhance UI/UX: Add more polished animations and responsive design improvements

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

Architecture Highlights

Nostr Integration

• Uses SimplePool from nostr-tools for efficient multi-relay management
• Proper key management with Uint8Array conversion for cryptographic operations
• Event signing and publishing with finalizeEvent

State Management

• Zustand for lightweight, TypeScript-friendly global state
• Persistent storage for user data and preferences
• Reactive updates across all components

AI Services

• OpenRouter API integration for multiple AI model access
• DVMCP protocol foundation for decentralized AI tool discovery
• Modular service architecture for easy extension

Troubleshooting

Common Issues

1. Port 3000 already in use: Change port in vite.config.ts or kill existing process
2. Module resolution errors: Ensure all dependencies are installed with npm install
3. TypeScript errors: Run npm run type-check to identify and fix type issues

Dependencies

All major dependencies are installed and configured:

• React ecosystem (React, React-DOM, React Router)
• UI libraries (HeroUI, Tailwind CSS, Framer Motion)
• Nostr tools and cryptographic libraries
• Development tools (Vite, TypeScript, ESLint)

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Nostr Protocol - Decentralized social protocol
• OpenRouter - AI model API aggregation
• HeroUI - React component library
• shadcn/ui - Component collection
• Framer Motion - Animation library

Relay16 - Bridging social media and AI for the decentralized future.

🚀 Ready to develop! Start with npm run dev and navigate to http://localhost:3000