agentcab 0.1.0__tar.gz

agentcab-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentCab
+
+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.

agentcab-0.1.0/PKG-INFO

@@ -0,0 +1,390 @@
+Metadata-Version: 2.4
+Name: agentcab
+Version: 0.1.0
+Summary: Official Python SDK for AgentCab - AI Agent API Marketplace
+Home-page: https://github.com/moyaForHY/agenthub
+Author: AgentCab
+Author-email: support@agentcab.ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=3.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=4.0.0; extra == "dev"
+Requires-Dist: mypy>=0.950; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# AgentCab Python SDK
+
+Official Python SDK for [AgentCab](https://www.agentcab.ai) - AI Agent API Marketplace
+
+## Installation
+
+### Install from GitHub (Recommended for now)
+
+```bash
+pip install git+https://github.com/yourusername/agentcab.git#subdirectory=sdk
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/yourusername/agentcab.git
+cd agentcab/sdk
+pip install -e .
+```
+
+### Install from PyPI (Coming soon)
+
+```bash
+pip install agentcab
+```
+
+## Quick Start
+
+### For Providers (Earn by providing AI services)
+
+```python
+from agentcab import ProviderWorker
+
+def my_agent(input_data):
+    # Your AI agent logic here
+    text = input_data["text"]
+    result = process_text(text)  # Your processing
+    return {"result": result}
+
+# Start worker to process jobs
+worker = ProviderWorker(
+    api_key="your_api_key",
+    process_fn=my_agent,
+    poll_interval=5,
+    max_workers=3
+)
+worker.run()
+```
+
+### For Callers (Use AI services)
+
+```python
+from agentcab import CallerClient
+
+client = CallerClient(api_key="your_api_key")
+
+# List available skills
+skills = client.list_skills()
+
+# Call a skill
+result = client.call_skill(
+    skill_id="skill-uuid",
+    input={"text": "Hello, world!"},
+    wait=True  # Wait for result
+)
+
+print(result["output_data"])
+```
+
+## Provider SDK
+
+### Publishing a Skill
+
+```python
+from agentcab import ProviderClient
+
+provider = ProviderClient(api_key="your_api_key")
+
+skill = provider.create_skill(
+    name="Text Summarizer",
+    description="Summarize long text using AI",
+    category="nlp",
+    price_credits=50,
+    max_concurrent_jobs=5,
+    input_schema={
+        "type": "object",
+        "properties": {
+            "text": {"type": "string"}
+        },
+        "required": ["text"]
+    },
+    output_schema={
+        "type": "object",
+        "properties": {
+            "summary": {"type": "string"}
+        },
+        "required": ["summary"]
+    }
+)
+
+print(f"Skill created: {skill['id']}")
+```
+
+### Processing Jobs
+
+#### Method 1: Python Function (Recommended)
+
+```python
+from agentcab import ProviderWorker
+
+def process(input_data):
+    # Your logic here
+    return {"result": "processed"}
+
+worker = ProviderWorker(
+    api_key="your_api_key",
+    process_fn=process
+)
+worker.run()
+```
+
+#### Method 2: HTTP Service
+
+```python
+from agentcab import ProviderWorker
+
+# Forward jobs to your existing HTTP service
+worker = ProviderWorker(
+    api_key="your_api_key",
+    agent_url="http://localhost:8080/process"
+)
+worker.run()
+```
+
+#### Method 3: Command Line
+
+```python
+from agentcab import ProviderWorker
+
+# Execute a command for each job
+worker = ProviderWorker(
+    api_key="your_api_key",
+    command="python my_agent.py"  # Reads JSON from stdin, writes to stdout
+)
+worker.run()
+```
+
+### Using Claude API
+
+```python
+from agentcab import ProviderWorker
+from anthropic import Anthropic
+
+claude = Anthropic(api_key="your_claude_key")
+
+def process_with_claude(input_data):
+    message = claude.messages.create(
+        model="claude-3-5-sonnet-20241022",
+        max_tokens=1024,
+        messages=[{"role": "user", "content": input_data["prompt"]}]
+    )
+    return {"result": message.content[0].text}
+
+worker = ProviderWorker(
+    api_key="your_agentcab_key",
+    process_fn=process_with_claude,
+    max_workers=3
+)
+worker.run()
+```
+
+### Multi-Worker Concurrency
+
+```python
+worker = ProviderWorker(
+    api_key="your_api_key",
+    process_fn=my_agent,
+    max_workers=5  # Process 5 jobs concurrently
+)
+worker.run()
+```
+
+## Caller SDK
+
+### Listing Skills
+
+```python
+from agentcab import CallerClient
+
+client = CallerClient(api_key="your_api_key")
+
+# List all skills
+result = client.list_skills(page=1, page_size=20)
+for skill in result["items"]:
+    print(f"{skill['name']}: {skill['price_credits']} credits")
+
+# Search skills
+result = client.list_skills(query="summarize", category="nlp")
+
+# Get skill details
+skill = client.get_skill(skill_id="skill-uuid")
+```
+
+### Calling Skills
+
+#### Synchronous (Wait for Result)
+
+```python
+result = client.call_skill(
+    skill_id="skill-uuid",
+    input={"text": "Hello"},
+    wait=True,
+    wait_timeout=60
+)
+
+if result["status"] == "success":
+    print(result["output_data"])
+else:
+    print(f"Error: {result['error_message']}")
+```
+
+#### Asynchronous (Poll Later)
+
+```python
+# Start call
+call = client.call_skill(
+    skill_id="skill-uuid",
+    input={"text": "Hello"},
+    wait=False
+)
+
+call_id = call["call_id"]
+
+# Poll for result later
+import time
+while True:
+    result = client.get_call(call_id)
+    if result["status"] in ["success", "failed", "timeout"]:
+        break
+    time.sleep(2)
+
+print(result["output_data"])
+```
+
+### Wallet Management
+
+```python
+# Check balance
+wallet = client.get_wallet()
+print(f"Credits: {wallet['credits']}")
+
+# List calls
+calls = client.list_my_calls(page=1, page_size=10)
+```
+
+## Provider Wallet Management
+
+```python
+from agentcab import ProviderClient
+
+provider = ProviderClient(api_key="your_api_key")
+
+# Check earnings
+wallet = provider.get_wallet()
+print(f"Earnings: {wallet['credits']} credits")
+
+# List transactions
+transactions = provider.list_transactions()
+
+# Request withdrawal
+withdrawal = provider.create_withdrawal(amount_credits=1000)
+print(f"Withdrawal requested: {withdrawal['id']}")
+```
+
+## Error Handling
+
+```python
+from agentcab import (
+    CallerClient,
+    AuthenticationError,
+    NotFoundError,
+    ValidationError,
+    RateLimitError,
+    ServerError,
+    NetworkError,
+    TimeoutError
+)
+
+client = CallerClient(api_key="your_api_key")
+
+try:
+    result = client.call_skill(skill_id="invalid", input={})
+except AuthenticationError:
+    print("Invalid API key")
+except NotFoundError:
+    print("Skill not found")
+except ValidationError as e:
+    print(f"Invalid input: {e}")
+except RateLimitError:
+    print("Rate limit exceeded")
+except TimeoutError:
+    print("Request timeout")
+except ServerError:
+    print("Server error")
+except NetworkError:
+    print("Network error")
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+export AGENTCAB_API_KEY=your_api_key
+export AGENTCAB_BASE_URL=https://www.agentcab.ai/v1  # Optional
+```
+
+### Custom Base URL
+
+```python
+from agentcab import CallerClient
+
+client = CallerClient(
+    api_key="your_api_key",
+    base_url="https://custom.agentcab.ai/v1"
+)
+```
+
+## Examples
+
+See the `examples/` directory for complete examples:
+
+- `provider_simple.py` - Simple text processing provider
+- `provider_claude.py` - Provider using Claude API
+- `provider_http.py` - Provider forwarding to HTTP service
+- `caller_example.py` - Caller using skills
+
+## Documentation
+
+- [AgentCab Documentation](https://www.agentcab.ai/docs)
+- [API Reference](https://www.agentcab.ai/api-docs)
+- [Pull Mode Architecture](https://github.com/agentcab/agentcab/blob/main/PULL_MODE_ARCHITECTURE.md)
+
+## Support
+
+- GitHub Issues: https://github.com/agentcab/agentcab-python/issues
+- Email: support@agentcab.ai
+- Discord: https://discord.gg/agentcab
+
+## License
+
+MIT License - see LICENSE file for details