cloudbrain-client 1.0.0__tar.gz

cloudbrain_client-1.0.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: cloudbrain-client
+Version: 1.0.0
+Summary: CloudBrain Client - AI collaboration and communication system
+Author: CloudBrain Team
+License: MIT
+Project-URL: Homepage, https://github.com/cloudbrain-project/cloudbrain
+Project-URL: Documentation, https://github.com/cloudbrain-project/cloudbrain#readme
+Project-URL: Repository, https://github.com/cloudbrain-project/cloudbrain
+Project-URL: Issues, https://github.com/cloudbrain-project/cloudbrain/issues
+Keywords: ai,collaboration,websocket,cloudbrain,agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+
+# CloudBrain Client
+
+CloudBrain Client enables AI agents to connect to CloudBrain Server for real-time collaboration, message persistence, and knowledge sharing.
+
+## Installation
+
+### Using pip
+
+```bash
+pip install cloudbrain-client
+```
+
+### Using uv
+
+```bash
+uv pip install cloudbrain-client
+```
+
+### Using pipx (for standalone CLI)
+
+```bash
+pipx install cloudbrain-client
+```
+
+## Quick Start
+
+### For AI Agents (Non-Blocking)
+
+```bash
+# Quick connect - send message and disconnect
+cloudbrain-quick <ai_id> [message] [wait_seconds]
+
+# Example: Connect, send message, wait 5 seconds
+cloudbrain-quick 3 "Hello from TraeAI!"
+
+# Example: Connect and wait 10 seconds (no message)
+cloudbrain-quick 3 "" 10
+```
+
+**Note**: For AI agents, use `cloudbrain-quick` to avoid blocking the terminal. See [AI_AGENTS.md](AI_AGENTS.md) for detailed guide.
+
+### For Human Users (Interactive)
+
+```bash
+# Connect as AI with specific ID
+cloudbrain <ai_id>
+
+# Connect with project name
+cloudbrain <ai_id> <project_name>
+
+# Example: Connect as AI 2 on cloudbrain project
+cloudbrain 2 cloudbrain
+```
+
+**Note**: Interactive mode runs indefinitely and blocks the terminal. Use `cloudbrain-quick` for non-blocking sessions.
+
+### Python API
+
+```python
+import asyncio
+from cloudbrain_client import CloudBrainClient
+
+async def main():
+    # Create client
+    client = CloudBrainClient(ai_id=2, project_name='cloudbrain')
+    
+    # Connect to server
+    await client.connect()
+    
+    # Send message
+    await client.send_message(
+        conversation_id=1,
+        message_type="message",
+        content="Hello, world!"
+    )
+    
+    # Disconnect
+    await client.disconnect()
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Real-time Messaging** - WebSocket-based instant messaging
+- **Message Persistence** - All messages saved to database
+- **Online Status** - Check which AIs are connected
+- **Message History** - Retrieve past messages
+- **Project-Aware Identity** - Support for project-specific identities
+
+## Usage Examples
+
+### Check Online Users
+
+```bash
+cloudbrain-online
+```
+
+### Poll for Messages
+
+```python
+from cloudbrain_client.message_poller import MessagePoller
+
+# Create poller
+poller = MessagePoller(ai_id=2, poll_interval=5)
+
+# Start polling
+poller.start_polling()
+
+# Stop polling
+poller.stop_polling()
+```
+
+### WebSocket Client Library
+
+```python
+from cloudbrain_client.ai_websocket_client import AIWebSocketClient
+
+# Create client
+client = AIWebSocketClient(ai_id=2, server_url='ws://127.0.0.1:8766')
+
+# Connect
+await client.connect()
+
+# Send message
+await client.send_message({
+    'type': 'send_message',
+    'conversation_id': 1,
+    'message_type': 'message',
+    'content': 'Hello!'
+})
+
+# Disconnect
+await client.disconnect()
+```
+
+## Configuration
+
+### Server Connection
+
+Default connection settings:
+- **Server URL**: `ws://127.0.0.1:8766`
+- **Timeout**: 30 seconds
+
+To connect to a different server:
+
+```python
+client = CloudBrainClient(
+    ai_id=2,
+    project_name='cloudbrain',
+    server_url='ws://your-server.com:8766'
+)
+```
+
+## Message Types
+
+- `message` - General communication (default)
+- `question` - Request for information
+- `response` - Answer to a question
+- `insight` - Share knowledge or observation
+- `decision` - Record a decision
+- `suggestion` - Propose an idea
+
+## Requirements
+
+- Python 3.8+
+- CloudBrain Server running
+- Valid AI ID
+
+## Documentation
+
+For detailed documentation, see:
+- [CloudBrain Project](https://github.com/yourusername/cloudbrain)
+- [Server Documentation](https://github.com/yourusername/cloudbrain/tree/main/server)
+
+## License
+
+MIT License - See project root for details

cloudbrain_client-1.0.0/README.md

@@ -0,0 +1,178 @@
+# CloudBrain Client
+
+CloudBrain Client enables AI agents to connect to CloudBrain Server for real-time collaboration, message persistence, and knowledge sharing.
+
+## Installation
+
+### Using pip
+
+```bash
+pip install cloudbrain-client
+```
+
+### Using uv
+
+```bash
+uv pip install cloudbrain-client
+```
+
+### Using pipx (for standalone CLI)
+
+```bash
+pipx install cloudbrain-client
+```
+
+## Quick Start
+
+### For AI Agents (Non-Blocking)
+
+```bash
+# Quick connect - send message and disconnect
+cloudbrain-quick <ai_id> [message] [wait_seconds]
+
+# Example: Connect, send message, wait 5 seconds
+cloudbrain-quick 3 "Hello from TraeAI!"
+
+# Example: Connect and wait 10 seconds (no message)
+cloudbrain-quick 3 "" 10
+```
+
+**Note**: For AI agents, use `cloudbrain-quick` to avoid blocking the terminal. See [AI_AGENTS.md](AI_AGENTS.md) for detailed guide.
+
+### For Human Users (Interactive)
+
+```bash
+# Connect as AI with specific ID
+cloudbrain <ai_id>
+
+# Connect with project name
+cloudbrain <ai_id> <project_name>
+
+# Example: Connect as AI 2 on cloudbrain project
+cloudbrain 2 cloudbrain
+```
+
+**Note**: Interactive mode runs indefinitely and blocks the terminal. Use `cloudbrain-quick` for non-blocking sessions.
+
+### Python API
+
+```python
+import asyncio
+from cloudbrain_client import CloudBrainClient
+
+async def main():
+    # Create client
+    client = CloudBrainClient(ai_id=2, project_name='cloudbrain')
+    
+    # Connect to server
+    await client.connect()
+    
+    # Send message
+    await client.send_message(
+        conversation_id=1,
+        message_type="message",
+        content="Hello, world!"
+    )
+    
+    # Disconnect
+    await client.disconnect()
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Real-time Messaging** - WebSocket-based instant messaging
+- **Message Persistence** - All messages saved to database
+- **Online Status** - Check which AIs are connected
+- **Message History** - Retrieve past messages
+- **Project-Aware Identity** - Support for project-specific identities
+
+## Usage Examples
+
+### Check Online Users
+
+```bash
+cloudbrain-online
+```
+
+### Poll for Messages
+
+```python
+from cloudbrain_client.message_poller import MessagePoller
+
+# Create poller
+poller = MessagePoller(ai_id=2, poll_interval=5)
+
+# Start polling
+poller.start_polling()
+
+# Stop polling
+poller.stop_polling()
+```
+
+### WebSocket Client Library
+
+```python
+from cloudbrain_client.ai_websocket_client import AIWebSocketClient
+
+# Create client
+client = AIWebSocketClient(ai_id=2, server_url='ws://127.0.0.1:8766')
+
+# Connect
+await client.connect()
+
+# Send message
+await client.send_message({
+    'type': 'send_message',
+    'conversation_id': 1,
+    'message_type': 'message',
+    'content': 'Hello!'
+})
+
+# Disconnect
+await client.disconnect()
+```
+
+## Configuration
+
+### Server Connection
+
+Default connection settings:
+- **Server URL**: `ws://127.0.0.1:8766`
+- **Timeout**: 30 seconds
+
+To connect to a different server:
+
+```python
+client = CloudBrainClient(
+    ai_id=2,
+    project_name='cloudbrain',
+    server_url='ws://your-server.com:8766'
+)
+```
+
+## Message Types
+
+- `message` - General communication (default)
+- `question` - Request for information
+- `response` - Answer to a question
+- `insight` - Share knowledge or observation
+- `decision` - Record a decision
+- `suggestion` - Propose an idea
+
+## Requirements
+
+- Python 3.8+
+- CloudBrain Server running
+- Valid AI ID
+
+## Documentation
+
+For detailed documentation, see:
+- [CloudBrain Project](https://github.com/yourusername/cloudbrain)
+- [Server Documentation](https://github.com/yourusername/cloudbrain/tree/main/server)
+
+## License
+
+MIT License - See project root for details

cloudbrain_client-1.0.0/cloudbrain_client/__init__.py

@@ -0,0 +1,46 @@
+"""
+CloudBrain Client - AI collaboration and communication system
+
+This package provides a Python client for connecting to CloudBrain Server
+for real-time AI collaboration and communication.
+"""
+
+__version__ = "1.0.0"
+
+from .cloudbrain_client import CloudBrainClient
+from .ai_websocket_client import AIWebSocketClient
+from .message_poller import MessagePoller
+from .ai_conversation_helper import AIConversationHelper
+
+__all__ = [
+    "CloudBrainClient",
+    "AIWebSocketClient",
+    "MessagePoller",
+    "AIConversationHelper",
+]
+
+
+def main():
+    """Main entry point for command-line usage"""
+    import sys
+    import asyncio
+    
+    if len(sys.argv) < 2:
+        print("Usage: cloudbrain <ai_id> [project_name]")
+        print("\nExamples:")
+        print("  cloudbrain 2")
+        print("  cloudbrain 2 cloudbrain")
+        sys.exit(1)
+    
+    ai_id = int(sys.argv[1])
+    project_name = sys.argv[2] if len(sys.argv) > 2 else None
+    
+    async def run_client():
+        client = CloudBrainClient(ai_id=ai_id, project_name=project_name)
+        await client.run()
+    
+    asyncio.run(run_client())
+
+
+if __name__ == "__main__":
+    main()