Eliza Agent Weaver

Eliza is a lightweight AI agent framework. It leverages Character files - JSON-formatted configurations that define an AI character's personality, knowledge, and behavior patterns.

Eliza Agent Weaver enables you to develop a set of Character files based on your own lore, and connects the narratives of multiple agents together through their character files.

Features

• Character Generation: Create detailed AI character profiles based on custom world lore
• Relationship Weaving: Automatically generate and visualize interconnected character relationships
• Rich Metadata: Generate comprehensive character attributes including:
  • Character bios and lore
  • Knowledge bases
  • Conversation examples
  • Writing style traits
  • Topics of interest
  • Personality adjectives
• Real-time Progress Tracking: Monitor character generation with detailed progress updates
• Export Capabilities: Download individual character profiles as JSON files

Tech Stack

• Frontend: React with Tailwind CSS
• Backend: Node.js with Express
• WebSocket: Real-time progress updates
• AI Integration: OpenAI GPT-4 API

Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• OpenAI API key
• Modern web browser

Installation

1. Clone the repository:

git clone https://github.com/yourusername/eliza-agent-weaver.git
cd eliza-agent-weaver

2. Install dependencies for both frontend and backend:

# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

Create two .env files:

In the backend directory:

OPENAI_API_KEY='YOUR API KEY HERE'
PORT=3001

In the root directory:

OPENAI_API_KEY='YOUR API KEY HERE'
SKIP_PREFLIGHT_CHECK=true

Running the Application

1. Start the backend server:

cd backend
npm start

2. Start the frontend development server:

cd frontend
npm start

3. Access the application at http://localhost:3000

Usage

1. Enter World Lore: Provide detailed background information about your world setting.

2. Add Character Names: List the names of characters you want to generate (one per line).

3. Configure Settings:

   • Enter your OpenAI API key
   • Set the number of characters to generate (1-9)
   • Adjust the temperature setting (0.0-1.0)

4. Generate Characters: Click "Generate Characters" and monitor the progress.

5. View Results:

   • Examine individual character profiles
   • Visualize character relationships
   • Download character data as JSON files

Character File Structure

Generated character files follow this structure:

{
  "name": "Character Name",
  "clients": [],
  "modelProvider": "anthropic",
  "settings": {
    "secrets": {},
    "voice": {
      "model": "en_US-male-medium"
    }
  },
  "plugins": [],
  "bio": ["Biography entries..."],
  "lore": ["Lore entries..."],
  "knowledge": ["Knowledge entries..."],
  "messageExamples": ["Message examples..."],
  "postExamples": ["Post examples..."],
  "topics": ["Topics of interest..."],
  "style": {
    "all": ["General style traits..."],
    "chat": ["Chat-specific style traits..."],
    "post": ["Post-specific style traits..."]
  },
  "adjectives": ["Character adjectives..."],
  "relationships": [
    {
      "name": "Other Character Name",
      "relationship": "Nature of relationship",
      "details": "Relationship details"
    }
  ]
}

Components

Frontend

• CharacterGenerator: Main application component
• CharacterViewer: Displays individual character profiles
• SimpleRelationshipView: Provides a simplified relationship view
• GenerationProgress: Shows real-time generation progress

Backend

• Express server handling character generation
• WebSocket server for real-time updates
• Character generation pipeline with retry mechanism
• Validation and error handling

License

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