From f1f5923a0c051f1c20c314f6fda436ad0499894d Mon Sep 17 00:00:00 2001
From: BusyBee3333 <jake@burtonmethod.com>
Date: Sat, 3 Jan 2026 09:19:08 -0500
Subject: [PATCH] Create README.md

---
 README.md | 99 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1dce41b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,99 @@
+# Claude Bot for Gather.town
+
+A Node.js-based AI agent that integrates Claude with Gather.town, allowing you to control an intelligent assistant avatar within your virtual office space.
+
+## Features
+
+- 🤖 Claude AI integration for intelligent responses
+- - 💬 Responds to commands in the Gather chat
+  - - 🚶 Can move around the virtual space
+    - - 🎯 Sits at desks and interacts with users
+      - - 🔌 Uses official Gather.town API
+       
+        - ## Setup Instructions
+       
+        - ### Prerequisites
+       
+        - 1. Node.js (v14 or higher)
+          2. 2. A Gather.town workspace with admin access
+             3. 3. An Anthropic API key (for Claude)
+                4. 4. The Gather.town API key (created in workspace settings)
+                  
+                   5. ### Installation
+                  
+                   6. 1. Clone or download this repository
+                      2. 2. Install dependencies:
+                         3. ```bash
+                            npm install
+                            ```
+
+                            3. Configure your environment:
+                            4. ```bash
+                               export GATHER_SPACE_ID="your-space-id"
+                               export GATHER_API_KEY="your-gather-api-key"
+                               export CLAUDE_API_KEY="your-anthropic-api-key"
+                               ```
+
+                               Or update the configuration in `bot.js`:
+                               ```javascript
+                               const GATHER_SPACE_ID = 'your-space-id';
+                               const GATHER_API_KEY = 'your-gather-api-key';
+                               const CLAUDE_API_KEY = 'your-anthropic-api-key';
+                               ```
+
+                               ### Running the Bot
+
+                               ```bash
+                               node bot.js
+                               ```
+
+                               The bot will initialize, take its position in the space, and begin listening for commands.
+
+                               ## Usage
+
+                               Users can interact with the bot using these commands:
+
+                               - **@claude [question]** - Ask Claude anything
+                               -   - Example: `@claude What is machine learning?`
+                                
+                                   -   - **come here** - Make the bot move to your location
+                                    
+                                       -   - **hello** - Greet the bot
+                                        
+                                           - ## Configuration
+                                        
+                                           - The bot's starting position can be adjusted in the configuration:
+                                        
+                                           - ```javascript
+                                             botState.position = { x: 10, y: 10 }; // Adjust coordinates as needed
+                                             ```
+
+                                             Desk coordinates can be found by hovering over locations in your Gather space.
+
+                                             ## API Keys
+
+                                             - **Gather.town API Key**: Create in Settings > API keys (workspace level)
+                                             - - **Anthropic (Claude) API Key**: Get from https://console.anthropic.com
+                                              
+                                               - ## Troubleshooting
+                                              
+                                               - - **Bot not responding**: Check that both API keys are valid and have proper permissions
+                                                 - - **Bot not moving**: Verify the space ID and coordinates are correct
+                                                   - - **Claude errors**: Ensure your Anthropic API key has sufficient credits
+                                                    
+                                                     - ## Future Enhancements
+                                                    
+                                                     - - WebSocket support for real-time message listening
+                                                       - - Custom desk assignments
+                                                         - - Multiple bot instances
+                                                           - - Memory/context retention across conversations
+                                                             - - Integration with Gather webhooks
+                                                               - - Customizable command prefixes
+                                                                
+                                                                 - ## License
+                                                                
+                                                                 - MIT
+                                                                
+                                                                 - ## Support
+                                                                
+                                                                 - For issues or questions, please check the Gather.town API documentation at https://docs.gather.town