Update README.md

README.md

@@ -1,2 +1,26 @@
-# opensim-ai-npc-framework
-AI-driven NPC framework for OpenSimulator with modular LSL scripts, sensing, pathfinding, and AI chat integration
+# AI-Driven NPC Framework for OpenSimulator
+
+This project is a modular, AI-driven NPC framework for OpenSimulator. It combines LSL scripts, environment sensing, pathfinding, gestures, and external AI models (local or cloud) to create more believable, context-aware NPCs.
+
+## Features
+
+- Modular six-script architecture (Main, Chat, Actions, Senses, Pathfinding, Gestures)
+- Environmental sensing and object awareness
+- AI-driven chat via multiple providers (local and cloud)
+- Pathfinding and obstacle avoidance
+- Gesture and animation system controlled via markers
+- Configuration via notecards (`general.cfg`, `personality.cfg`, `seating.cfg`, `appearance.txt`)
+
+## Status
+
+This project is under active development. Feedback, testing, and suggestions are welcome.
+
+## Licensing
+
+This project is dual-licensed:
+- Under the GNU Affero General Public License v3.0 (AGPL v3) for open source use.
+- Under a separate commercial license for organizations that need to use it without AGPL obligations.
+
+I am still exploring the best licensing and distribution options and am especially interested in whether there is real interest in an AI-driven NPC framework for OpenSimulator.
+
+For questions, feedback, or licensing discussions, contact: opensim.npc.framework@gmail.com.