youclaw 4.6.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Imran
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,128 @@
1
+ Metadata-Version: 2.1
2
+ Name: youclaw
3
+ Version: 4.6.0
4
+ Summary: Your Personal AI Assistant - Universal Neural Core
5
+ Author-email: Imran <imran@example.com>
6
+ Classifier: Programming Language :: Python :: 3
7
+ Classifier: License :: OSI Approved :: MIT License
8
+ Classifier: Operating System :: OS Independent
9
+ Requires-Python: >=3.10
10
+ Description-Content-Type: text/markdown
11
+ License-File: LICENSE
12
+ Requires-Dist: aiosqlite
13
+ Requires-Dist: aiohttp
14
+ Requires-Dist: aiohttp-jinja2
15
+ Requires-Dist: jinja2
16
+ Requires-Dist: python-dotenv
17
+ Requires-Dist: apscheduler
18
+ Requires-Dist: python-telegram-bot
19
+ Requires-Dist: discord.py
20
+ Requires-Dist: httpx
21
+ Requires-Dist: beautifulsoup4
22
+
23
+ # 🦞 YouClaw - Your Personal AI Assistant
24
+
25
+ **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.
26
+
27
+ ## ✨ Features
28
+
29
+ - 🤖 **Multi-Platform**: Telegram, Discord, and Web Dashboard
30
+ - 🧠 **Semantic Memory**: Remembers context using vector embeddings
31
+ - ⚡ **AI Cron Jobs**: Schedule recurring AI-powered tasks
32
+ - 🔍 **Real-Time Search**: Integrated web search for up-to-date information
33
+ - 📧 **Email Integration**: Send and check emails via AI commands
34
+ - 🎭 **Multiple Personalities**: Switch between different AI personas
35
+ - 🛡️ **Admin Controls**: Full control over your personal instance
36
+ - 📦 **Self-Contained**: No external API keys required (uses local Ollama)
37
+
38
+ ## 🚀 Quick Start
39
+
40
+ ### Prerequisites
41
+
42
+ - Python 3.10+
43
+ - [Ollama](https://ollama.ai) installed and running locally
44
+
45
+ ### Installation
46
+
47
+ ```bash
48
+ pip install youclaw
49
+ ```
50
+
51
+ ### First Run
52
+
53
+ ```bash
54
+ youclaw start
55
+ ```
56
+
57
+ This will launch the **Neural Wizard** - an interactive setup that guides you through:
58
+ - Telegram bot token configuration
59
+ - Discord bot token configuration
60
+ - Search engine URL (optional)
61
+ - Email credentials (optional)
62
+
63
+ You can skip any step and configure it later via the dashboard.
64
+
65
+ ### Access Dashboard
66
+
67
+ After setup, access your Mission Control at:
68
+ ```
69
+ http://localhost:8080
70
+ ```
71
+
72
+ ## 📖 Usage
73
+
74
+ ### CLI Commands
75
+
76
+ ```bash
77
+ youclaw start # Start YouClaw (runs wizard if unconfigured)
78
+ youclaw check # Health check
79
+ youclaw dashboard # Start dashboard only
80
+ ```
81
+
82
+ ### Creating Your First Admin Account
83
+
84
+ 1. Navigate to `http://localhost:8080`
85
+ 2. Click "Register"
86
+ 3. Create your account (first user is automatically admin)
87
+ 4. Access the ROOT PROTOCOLS panel at the bottom
88
+
89
+ ## 🔧 Configuration
90
+
91
+ YouClaw stores configuration in `.env` and uses SQLite for data persistence.
92
+
93
+ ### Environment Variables
94
+
95
+ ```bash
96
+ OLLAMA_HOST=http://localhost:11434
97
+ OLLAMA_MODEL=qwen2.5:1.5b-instruct
98
+ TELEGRAM_BOT_TOKEN=your_token_here
99
+ DISCORD_BOT_TOKEN=your_token_here
100
+ SEARCH_ENGINE_URL=http://your-search-engine/search
101
+ ```
102
+
103
+ ## 🛡️ Security
104
+
105
+ - **Universal Admin**: Every user on your personal clone has full admin rights
106
+ - **Local-First**: All data stays on your machine
107
+ - **Token-Based Auth**: Secure session management for the dashboard
108
+ - **No Cloud Dependencies**: Runs entirely offline (except for bot platforms)
109
+
110
+ ## 📝 License
111
+
112
+ MIT License - See LICENSE file for details
113
+
114
+ ## 🤝 Contributing
115
+
116
+ Contributions are welcome! This is an open-source personal AI assistant project.
117
+
118
+ ## 🐛 Issues
119
+
120
+ Report issues on GitHub: [Your Repository URL]
121
+
122
+ ## 💬 Community
123
+
124
+ Join the discussion: [Your Community Link]
125
+
126
+ ---
127
+
128
+ **Made with 🦞 by the YouClaw Community**
@@ -0,0 +1,24 @@
1
+ youclaw/__init__.py,sha256=O-gFt_L-TungI3JyIY56YGTiizaIjpKKTWBVAWToqmg,539
2
+ youclaw/bot.py,sha256=-kpw0AE4svBrdz0ZpcJIZi-ZQT1yy_mXIcpRKqei6r4,5931
3
+ youclaw/cli.py,sha256=tbqa4BuWJtxllPQ8CFr3CtspCGsCebOROOQQGG8XqO4,16854
4
+ youclaw/commands.py,sha256=ljexFjbRoTyZmGKswLzOXa03WocuCzYzCYE8A08WbzE,5401
5
+ youclaw/config.py,sha256=I-74d7y--94Pee2yHj2CssILoqpO5b4UUVBVvYCMnOk,6559
6
+ youclaw/core_skills.py,sha256=AyoBq3LqTiwsNvVehi4T7RMGtd1J-lI-YL_owuj5ZUQ,9227
7
+ youclaw/dashboard.py,sha256=IJLYLYkMp4OSVl3lyUr-p4gWgInz8Nrz0w5JaqQ2lTA,68141
8
+ youclaw/discord_handler.py,sha256=L3bsptg2gtpXm_HOcqmHrT45KqshnAkBXzM0S6I1o2g,7184
9
+ youclaw/env_manager.py,sha256=uvR5ix7hB8gyv6yStRfq6s7o-ALw-dead81GI8u0CPE,1867
10
+ youclaw/main.py,sha256=5hk17gusRviT1LpAEQ1uUZFZmmmf2tpiJ8OFoF5mflA,9090
11
+ youclaw/memory_manager.py,sha256=Y4oli_dI2PdYmiFyK5QeE7UQdb6SmRiOQMVGEsSdnX4,16399
12
+ youclaw/ollama_client.py,sha256=qlU3eVf8DkOm8zoioxitsB09Dh9SLwbmFHOh0Jk-_Jw,21148
13
+ youclaw/personality_manager.py,sha256=8FFpa-a0OZDkWp0Wlt3LhLixZRBNGN7eHppSUHYsbH4,1489
14
+ youclaw/scheduler_manager.py,sha256=-9SfaaHGZ2vluY6vkjmsNFPS0MNLwrEFtrQc2w2Am5E,8609
15
+ youclaw/search_client.py,sha256=fSbflx5nclGhMfFxNScaNM15RKxO_dQbCgtId7Ggmjk,2984
16
+ youclaw/skills_manager.py,sha256=useUV9eLY_sFULY1jHNjyD_VteU-aN8Lw6OKqdnuZNc,5183
17
+ youclaw/telegram_handler.py,sha256=is34s3QPtJyph5HfBb_Xw6dUCzOJb2NXqt3ylApX96E,6288
18
+ youclaw/vector_manager.py,sha256=8gvYst6JoFzLKl7syaeN4WKPPCXXuEG-gTX15uL8b5g,3390
19
+ youclaw-4.6.0.dist-info/LICENSE,sha256=2p_ENMOp0sRMAVx7k1vauyHfQk7npVn1J99Re-LXY6o,1062
20
+ youclaw-4.6.0.dist-info/METADATA,sha256=h64zYIxF3YvtMN7siLGSd3HUSZIfeJm9f89hSnwOcjI,3416
21
+ youclaw-4.6.0.dist-info/WHEEL,sha256=hPN0AlP2dZM_3ZJZWP4WooepkmU9wzjGgCLCeFjkHLA,92
22
+ youclaw-4.6.0.dist-info/entry_points.txt,sha256=TCRvZ6l9mCoPRBAyCwRzupie6FozD-2r540ILLLkiI0,45
23
+ youclaw-4.6.0.dist-info/top_level.txt,sha256=q_WatC9Fthh_kLowtWqF7HeslKTJNKNjaWU5yxgo9Lk,8
24
+ youclaw-4.6.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: bdist_wheel (0.46.3)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ youclaw = youclaw.cli:main
@@ -0,0 +1 @@
1
+ youclaw