youclaw 4.6.0__tar.gz

youclaw-4.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Imran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

youclaw-4.6.0/MANIFEST.in

@@ -0,0 +1,8 @@
+recursive-exclude data *
+recursive-exclude __pycache__ *
+exclude .env
+exclude bot_output.log
+exclude youclaw.log
+exclude test_*.py
+exclude *.db
+exclude *.sqlite

youclaw-4.6.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.1
+Name: youclaw
+Version: 4.6.0
+Summary: Your Personal AI Assistant - Universal Neural Core
+Author-email: Imran <imran@example.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiosqlite
+Requires-Dist: aiohttp
+Requires-Dist: aiohttp-jinja2
+Requires-Dist: jinja2
+Requires-Dist: python-dotenv
+Requires-Dist: apscheduler
+Requires-Dist: python-telegram-bot
+Requires-Dist: discord.py
+Requires-Dist: httpx
+Requires-Dist: beautifulsoup4
+
+# 🦞 YouClaw - Your Personal AI Assistant
+
+**YouClaw** is a powerful, self-hosted AI assistant that connects to Telegram, Discord, and a beautiful web dashboard. Built with privacy in mind, all your data stays on your machine.
+
+## ✨ Features
+
+- 🤖 **Multi-Platform**: Telegram, Discord, and Web Dashboard
+- 🧠 **Semantic Memory**: Remembers context using vector embeddings
+- ⚡ **AI Cron Jobs**: Schedule recurring AI-powered tasks
+- 🔍 **Real-Time Search**: Integrated web search for up-to-date information
+- 📧 **Email Integration**: Send and check emails via AI commands
+- 🎭 **Multiple Personalities**: Switch between different AI personas
+- 🛡️ **Admin Controls**: Full control over your personal instance
+- 📦 **Self-Contained**: No external API keys required (uses local Ollama)
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python 3.10+
+- [Ollama](https://ollama.ai) installed and running locally
+
+### Installation
+
+```bash
+pip install youclaw
+```
+
+### First Run
+
+```bash
+youclaw start
+```
+
+This will launch the **Neural Wizard** - an interactive setup that guides you through:
+- Telegram bot token configuration
+- Discord bot token configuration  
+- Search engine URL (optional)
+- Email credentials (optional)
+
+You can skip any step and configure it later via the dashboard.
+
+### Access Dashboard
+
+After setup, access your Mission Control at:
+```
+http://localhost:8080
+```
+
+## 📖 Usage
+
+### CLI Commands
+
+```bash
+youclaw start      # Start YouClaw (runs wizard if unconfigured)
+youclaw check      # Health check
+youclaw dashboard  # Start dashboard only
+```
+
+### Creating Your First Admin Account
+
+1. Navigate to `http://localhost:8080`
+2. Click "Register"
+3. Create your account (first user is automatically admin)
+4. Access the ROOT PROTOCOLS panel at the bottom
+
+## 🔧 Configuration
+
+YouClaw stores configuration in `.env` and uses SQLite for data persistence.
+
+### Environment Variables
+
+```bash
+OLLAMA_HOST=http://localhost:11434
+OLLAMA_MODEL=qwen2.5:1.5b-instruct
+TELEGRAM_BOT_TOKEN=your_token_here
+DISCORD_BOT_TOKEN=your_token_here
+SEARCH_ENGINE_URL=http://your-search-engine/search
+```
+
+## 🛡️ Security
+
+- **Universal Admin**: Every user on your personal clone has full admin rights
+- **Local-First**: All data stays on your machine
+- **Token-Based Auth**: Secure session management for the dashboard
+- **No Cloud Dependencies**: Runs entirely offline (except for bot platforms)
+
+## 📝 License
+
+MIT License - See LICENSE file for details
+
+## 🤝 Contributing
+
+Contributions are welcome! This is an open-source personal AI assistant project.
+
+## 🐛 Issues
+
+Report issues on GitHub: [Your Repository URL]
+
+## 💬 Community
+
+Join the discussion: [Your Community Link]
+
+---
+
+**Made with 🦞 by the YouClaw Community**

youclaw-4.6.0/README.md

@@ -0,0 +1,106 @@
+# 🦞 YouClaw - Your Personal AI Assistant
+
+**YouClaw** is a powerful, self-hosted AI assistant that connects to Telegram, Discord, and a beautiful web dashboard. Built with privacy in mind, all your data stays on your machine.
+
+## ✨ Features
+
+- 🤖 **Multi-Platform**: Telegram, Discord, and Web Dashboard
+- 🧠 **Semantic Memory**: Remembers context using vector embeddings
+- ⚡ **AI Cron Jobs**: Schedule recurring AI-powered tasks
+- 🔍 **Real-Time Search**: Integrated web search for up-to-date information
+- 📧 **Email Integration**: Send and check emails via AI commands
+- 🎭 **Multiple Personalities**: Switch between different AI personas
+- 🛡️ **Admin Controls**: Full control over your personal instance
+- 📦 **Self-Contained**: No external API keys required (uses local Ollama)
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python 3.10+
+- [Ollama](https://ollama.ai) installed and running locally
+
+### Installation
+
+```bash
+pip install youclaw
+```
+
+### First Run
+
+```bash
+youclaw start
+```
+
+This will launch the **Neural Wizard** - an interactive setup that guides you through:
+- Telegram bot token configuration
+- Discord bot token configuration  
+- Search engine URL (optional)
+- Email credentials (optional)
+
+You can skip any step and configure it later via the dashboard.
+
+### Access Dashboard
+
+After setup, access your Mission Control at:
+```
+http://localhost:8080
+```
+
+## 📖 Usage
+
+### CLI Commands
+
+```bash
+youclaw start      # Start YouClaw (runs wizard if unconfigured)
+youclaw check      # Health check
+youclaw dashboard  # Start dashboard only
+```
+
+### Creating Your First Admin Account
+
+1. Navigate to `http://localhost:8080`
+2. Click "Register"
+3. Create your account (first user is automatically admin)
+4. Access the ROOT PROTOCOLS panel at the bottom
+
+## 🔧 Configuration
+
+YouClaw stores configuration in `.env` and uses SQLite for data persistence.
+
+### Environment Variables
+
+```bash
+OLLAMA_HOST=http://localhost:11434
+OLLAMA_MODEL=qwen2.5:1.5b-instruct
+TELEGRAM_BOT_TOKEN=your_token_here
+DISCORD_BOT_TOKEN=your_token_here
+SEARCH_ENGINE_URL=http://your-search-engine/search
+```
+
+## 🛡️ Security
+
+- **Universal Admin**: Every user on your personal clone has full admin rights
+- **Local-First**: All data stays on your machine
+- **Token-Based Auth**: Secure session management for the dashboard
+- **No Cloud Dependencies**: Runs entirely offline (except for bot platforms)
+
+## 📝 License
+
+MIT License - See LICENSE file for details
+
+## 🤝 Contributing
+
+Contributions are welcome! This is an open-source personal AI assistant project.
+
+## 🐛 Issues
+
+Report issues on GitHub: [Your Repository URL]
+
+## 💬 Community
+
+Join the discussion: [Your Community Link]
+
+---
+
+**Made with 🦞 by the YouClaw Community**

youclaw-4.6.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=61.0,<69.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "youclaw"
+version = "4.6.0"
+authors = [
+  { name="Imran", email="imran@example.com" },
+]
+description = "Your Personal AI Assistant - Universal Neural Core"
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "aiosqlite",
+    "aiohttp",
+    "aiohttp-jinja2",
+    "jinja2",
+    "python-dotenv",
+    "apscheduler",
+    "python-telegram-bot",
+    "discord.py",
+    "httpx",
+    "beautifulsoup4",
+]
+
+[project.scripts]
+youclaw = "youclaw.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+exclude = ["tests*", "data*", "*.log", ".env*"]
+
+[tool.setuptools.package-data]
+youclaw = ["*.html", "*.css", "*.js"]

youclaw-4.6.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

youclaw-4.6.0/src/youclaw/__init__.py

@@ -0,0 +1,24 @@
+"""
+YouClaw - Your Personal AI Assistant
+Universal Neural Core for Telegram, Discord, and Web Dashboard
+"""
+
+__version__ = "4.6.0"
+__author__ = "Imran"
+
+from .bot import youclaw_bot, main
+from .config import config
+from .memory_manager import memory_manager
+from .ollama_client import ollama_client
+from .scheduler_manager import scheduler_manager
+from .skills_manager import skill_manager
+
+__all__ = [
+    "youclaw_bot",
+    "main",
+    "config",
+    "memory_manager",
+    "ollama_client",
+    "scheduler_manager",
+    "skill_manager",
+]

youclaw-4.6.0/src/youclaw/bot.py

@@ -0,0 +1,185 @@
+"""
+YouClaw - Your Personal AI Assistant
+Main bot orchestrator that runs Discord and Telegram handlers concurrently.
+"""
+
+import asyncio
+import logging
+import signal
+import sys
+from .config import config
+from .ollama_client import ollama_client
+from .memory_manager import memory_manager
+from .scheduler_manager import scheduler_manager
+from .discord_handler import discord_handler
+from .telegram_handler import telegram_handler
+from .dashboard import run_dashboard
+from .skills_manager import skill_manager
+
+# Set up logging
+logging.basicConfig(
+    level=getattr(logging, config.bot.log_level),
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+    handlers=[
+        logging.StreamHandler(sys.stdout),
+        logging.FileHandler('youclaw.log')
+    ]
+)
+
+logger = logging.getLogger(__name__)
+
+
+class YouClaw:
+    """Main YouClaw bot orchestrator"""
+    
+    def __init__(self):
+        self.running = False
+        self.platform_tasks = []
+        self.dashboard_task = None
+        self.stop_event = asyncio.Event()
+    
+    async def initialize(self):
+        """Initialize bot cores"""
+        logger.info("🦞 Initializing YouClaw...")
+        
+        # Initialize memory manager
+        await memory_manager.initialize()
+        
+        # Initialize Ollama client
+        await ollama_client.initialize()
+        
+        # Initialize scheduler manager
+        scheduler_manager.initialize(self, config.bot.database_path)
+        
+        # Load dynamic skills
+        skill_manager.load_dynamic_skills()
+        
+        logger.info("🤖 YouClaw Cores Initialized")
+        
+        # Check Ollama health
+        if not await ollama_client.check_health():
+            logger.error("❌ Ollama is not available!")
+            # Don't exit here, maybe user will fix it via dashboard? 
+            # Actually, we need Ollama for core features, but dashboard should stay up.
+        
+        # Load initial config from DB
+        await config.refresh_from_db()
+        logger.info("🚀 YouClaw initialization complete!")
+    
+    async def _start_platforms(self):
+        """Internal method to start enabled platforms"""
+        # Clear existing tasks
+        for task in self.platform_tasks:
+            task.cancel()
+        self.platform_tasks = []
+        
+        if config.discord.enabled and config.discord.token:
+            logger.info("Starting Discord handler...")
+            task = asyncio.create_task(discord_handler.start())
+            self.platform_tasks.append(task)
+        elif config.discord.enabled:
+            logger.warning("Discord enabled but no token provided!")
+
+        if config.telegram.enabled and config.telegram.token:
+            logger.info("Starting Telegram handler...")
+            task = asyncio.create_task(telegram_handler.start())
+            self.platform_tasks.append(task)
+        elif config.telegram.enabled:
+            logger.warning("Telegram enabled but no token provided!")
+
+        if not self.platform_tasks:
+            logger.info("No platform handlers started. Bot is in standby mode.")
+
+    async def start(self):
+        """Start all enabled platform handlers"""
+        self.running = True
+        await self._start_platforms()
+        
+        logger.info("✅ All platforms started. YouClaw is now online! 🦞")
+        
+        # Keep running until stop_event is set
+        await self.stop_event.wait()
+    
+    async def restart_handlers(self):
+        """Refresh config and restart platform handlers ONLY (keep dashboard alive)"""
+        logger.info("♻️ Restarting handlers with fresh config...")
+        
+        # Stop current platform handlers
+        await discord_handler.stop()
+        await telegram_handler.stop()
+        
+        # Refresh configuration from database
+        await config.refresh_from_db()
+        
+        # Start platforms again
+        await self._start_platforms()
+        logger.info("✅ Handlers restarted successfully")
+
+    async def shutdown(self):
+        """Gracefully shutdown all components"""
+        logger.info("🛑 Shutting down YouClaw...")
+        self.running = False
+        
+        # Set stop event to break the start() wait
+        self.stop_event.set()
+        
+        # Cancel all platform tasks
+        for task in self.platform_tasks:
+            task.cancel()
+        
+        # Cancel dashboard
+        if self.dashboard_task:
+            self.dashboard_task.cancel()
+        
+        # Stop platform handlers
+        await discord_handler.stop()
+        await telegram_handler.stop()
+        
+        # Close connections
+        await ollama_client.close()
+        await memory_manager.close()
+        
+        logger.info("👋 YouClaw shutdown complete")
+    
+    def handle_signal(self, sig):
+        """Handle shutdown signals"""
+        logger.info(f"Received signal {sig}, initiating shutdown...")
+        asyncio.create_task(self.shutdown())
+
+
+# Global bot instance
+youclaw_bot = YouClaw()
+
+async def main():
+    """Main entry point"""
+    # Initialize cores
+    await youclaw_bot.initialize()
+    
+    # Set up signal handlers
+    loop = asyncio.get_event_loop()
+    for sig in (signal.SIGTERM, signal.SIGINT):
+        loop.add_signal_handler(sig, lambda s=sig: youclaw_bot.handle_signal(s))
+    
+    try:
+        # Start Dashboard as a background task
+        # We pass the bot instance so the dashboard can control it
+        logger.info("Starting Web Dashboard...")
+        youclaw_bot.dashboard_task = asyncio.create_task(run_dashboard(youclaw_bot, port=8080))
+        
+        # Start bot handlers (this blocks until shutdown)
+        await youclaw_bot.start()
+    
+    except asyncio.CancelledError:
+        pass
+    except Exception as e:
+        logger.error(f"Fatal error: {e}", exc_info=True)
+    finally:
+        await youclaw_bot.shutdown()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        pass
+