cyka-agent 0.1.0__tar.gz

cyka_agent-0.1.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: cyka-agent
+Version: 0.1.0
+Summary: Python SDK for Cykani stealth browser automation and AI agents
+Author-email: Cykani <dev@cykani.com>
+License: Apache-2.0
+Project-URL: Homepage, https://cykani.com
+Project-URL: Documentation, https://docs.cykani.com
+Project-URL: Repository, https://github.com/cykani/cyka-agent
+Project-URL: Issues, https://github.com/cykani/cyka-agent/issues
+Keywords: browser,automation,stealth,anti-detection,ai-agent,scraping
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: websockets>=11.0
+Provides-Extra: llm
+Requires-Dist: openai>=1.0.0; extra == "llm"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+
+# cyka-agent Python SDK
+
+Python SDK for Cykani stealth browser automation and AI agents.
+
+## Installation
+
+```bash
+pip install cyka-agent
+```
+
+For LLM support:
+
+```bash
+pip install cyka-agent[llm]
+```
+
+## Quick Start
+
+### Manual Browser Control
+
+```python
+import asyncio
+from cyka_agent import Browser
+
+async def main():
+    browser = await Browser.connect("ws://localhost:9222")
+    
+    await browser.goto("https://example.com")
+    await browser.click("#login-button")
+    await browser.type("#email", "user@example.com")
+    text = await browser.extract("#content")
+    
+    print(text)
+    await browser.disconnect()
+
+asyncio.run(main())
+```
+
+### AI Agent (Autonomous)
+
+```python
+import asyncio
+from cyka_agent import Agent, Browser, AgentConfig
+
+async def main():
+    browser = await Browser.connect("ws://localhost:9222")
+    
+    agent = Agent.create(
+        session=browser._session,
+        config=AgentConfig(
+            session_id="",
+            profile_id="",
+            goal="Find the cheapest iPhone on Amazon and add to cart",
+            max_steps=25,
+        ),
+    )
+    
+    result = await agent.run_async()
+    print(result.status)  # "success" or "max_steps_exceeded"
+    print(result.result)  # What was accomplished
+
+asyncio.run(main())
+```
+
+### Tool-Based (For LLM Integration)
+
+```python
+import asyncio
+from cyka_agent import Browser, BrowserTools
+
+async def main():
+    browser = await Browser.connect("ws://localhost:9222")
+    session = browser._session
+    
+    tools = BrowserTools(session)
+    
+    # Get tool definitions for your LLM
+    tool_defs = tools.get_definitions()
+    
+    # Use with any LLM (example: OpenAI)
+    from openai import OpenAI
+    client = OpenAI()
+    
+    response = client.chat.completions.create(
+        model="gpt-4",
+        messages=[{"role": "user", "content": "Navigate to example.com"}],
+        tools=tool_defs,
+    )
+    
+    # Execute the tool call
+    tool_call = response.choices[0].message.tool_calls[0]
+    result = await tools.execute(
+        tool_call.function.name,
+        eval(tool_call.function.arguments),
+    )
+    
+    print(result.output)
+
+asyncio.run(main())
+```
+
+### Using with Cykani API
+
+```python
+from cyka_agent import CykaClient
+
+client = CykaClient(
+    api_url="http://localhost:3001",
+    api_key="your-api-key",
+)
+
+# Create a session
+session = client.sessions.create(profile_id="profile-123")
+print(session.cdp_endpoint)  # ws://localhost:9222
+
+# Start the session
+session = client.sessions.start(session.id)
+
+# Create and run an agent
+agent = client.agents.create(
+    session_id=session.id,
+    profile_id="profile-123",
+    goal="Scrape all product prices",
+)
+result = client.agents.run(agent["id"])
+print(result)
+```
+
+## Supported LLM Providers
+
+- OpenAI (GPT-4, GPT-3.5)
+- Anthropic (Claude)
+- Any OpenAI-compatible API (Hermes, Groq, etc.)
+
+## Environment Variables
+
+```bash
+CYKANI_API_URL=http://localhost:3001
+CYKANI_API_KEY=your-api-key
+OPENAI_API_KEY=your-openai-key  # For OpenAI adapter
+```
+
+## License
+
+Apache-2.0

cyka_agent-0.1.0/README.md

@@ -0,0 +1,145 @@
+# cyka-agent Python SDK
+
+Python SDK for Cykani stealth browser automation and AI agents.
+
+## Installation
+
+```bash
+pip install cyka-agent
+```
+
+For LLM support:
+
+```bash
+pip install cyka-agent[llm]
+```
+
+## Quick Start
+
+### Manual Browser Control
+
+```python
+import asyncio
+from cyka_agent import Browser
+
+async def main():
+    browser = await Browser.connect("ws://localhost:9222")
+    
+    await browser.goto("https://example.com")
+    await browser.click("#login-button")
+    await browser.type("#email", "user@example.com")
+    text = await browser.extract("#content")
+    
+    print(text)
+    await browser.disconnect()
+
+asyncio.run(main())
+```
+
+### AI Agent (Autonomous)
+
+```python
+import asyncio
+from cyka_agent import Agent, Browser, AgentConfig
+
+async def main():
+    browser = await Browser.connect("ws://localhost:9222")
+    
+    agent = Agent.create(
+        session=browser._session,
+        config=AgentConfig(
+            session_id="",
+            profile_id="",
+            goal="Find the cheapest iPhone on Amazon and add to cart",
+            max_steps=25,
+        ),
+    )
+    
+    result = await agent.run_async()
+    print(result.status)  # "success" or "max_steps_exceeded"
+    print(result.result)  # What was accomplished
+
+asyncio.run(main())
+```
+
+### Tool-Based (For LLM Integration)
+
+```python
+import asyncio
+from cyka_agent import Browser, BrowserTools
+
+async def main():
+    browser = await Browser.connect("ws://localhost:9222")
+    session = browser._session
+    
+    tools = BrowserTools(session)
+    
+    # Get tool definitions for your LLM
+    tool_defs = tools.get_definitions()
+    
+    # Use with any LLM (example: OpenAI)
+    from openai import OpenAI
+    client = OpenAI()
+    
+    response = client.chat.completions.create(
+        model="gpt-4",
+        messages=[{"role": "user", "content": "Navigate to example.com"}],
+        tools=tool_defs,
+    )
+    
+    # Execute the tool call
+    tool_call = response.choices[0].message.tool_calls[0]
+    result = await tools.execute(
+        tool_call.function.name,
+        eval(tool_call.function.arguments),
+    )
+    
+    print(result.output)
+
+asyncio.run(main())
+```
+
+### Using with Cykani API
+
+```python
+from cyka_agent import CykaClient
+
+client = CykaClient(
+    api_url="http://localhost:3001",
+    api_key="your-api-key",
+)
+
+# Create a session
+session = client.sessions.create(profile_id="profile-123")
+print(session.cdp_endpoint)  # ws://localhost:9222
+
+# Start the session
+session = client.sessions.start(session.id)
+
+# Create and run an agent
+agent = client.agents.create(
+    session_id=session.id,
+    profile_id="profile-123",
+    goal="Scrape all product prices",
+)
+result = client.agents.run(agent["id"])
+print(result)
+```
+
+## Supported LLM Providers
+
+- OpenAI (GPT-4, GPT-3.5)
+- Anthropic (Claude)
+- Any OpenAI-compatible API (Hermes, Groq, etc.)
+
+## Environment Variables
+
+```bash
+CYKANI_API_URL=http://localhost:3001
+CYKANI_API_KEY=your-api-key
+OPENAI_API_KEY=your-openai-key  # For OpenAI adapter
+```
+
+## License
+
+Apache-2.0

cyka_agent-0.1.0/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cyka-agent"
+version = "0.1.0"
+description = "Python SDK for Cykani stealth browser automation and AI agents"
+readme = "README.md"
+license = {text = "Apache-2.0"}
+requires-python = ">=3.9"
+authors = [
+    {name = "Cykani", email = "dev@cykani.com"}
+]
+keywords = ["browser", "automation", "stealth", "anti-detection", "ai-agent", "scraping"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP :: Browsers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "httpx>=0.24.0",
+    "pydantic>=2.0.0",
+    "websockets>=11.0",
+]
+
+[project.optional-dependencies]
+llm = [
+    "openai>=1.0.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://cykani.com"
+Documentation = "https://docs.cykani.com"
+Repository = "https://github.com/cykani/cyka-agent"
+Issues = "https://github.com/cykani/cyka-agent/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+
+[tool.mypy]
+python_version = "3.9"
+strict = true
+warn_return_any = true
+warn_unused_configs = true

cyka_agent-0.1.0/setup.cfg

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

cyka_agent-0.1.0/src/cyka_agent/__init__.py

@@ -0,0 +1,60 @@
+"""
+cyka-agent — Python SDK for Cykani stealth browser automation.
+
+Provides:
+- Browser session management with stealth patches
+- AI agent execution loop (LLM-powered)
+- Tool registry for browser interactions
+- Integration with OpenAI, Hermes, and other LLM providers
+
+Usage:
+    from cyka_agent import CykaClient, Agent, Browser
+
+    client = CykaClient(api_url="http://localhost:3001", api_key="your-key")
+    session = client.sessions.create(profile_id="profile-123")
+    browser = Browser.connect(session.cdp_endpoint)
+    browser.goto("https://example.com")
+"""
+
+__version__ = "0.1.0"
+
+from .client import CykaClient
+from .agent import Agent, AgentConfig, AgentResult
+from .browser import Browser, BrowserSession
+from .types import (
+    ToolDefinition,
+    ToolCall,
+    ToolResult,
+    ChatMessage,
+    CompletionResult,
+    TokenUsage,
+    Plan,
+    Step,
+    StepLogEntry,
+    PerceptionSnapshot,
+    InteractiveElement,
+    ProgressEvent,
+)
+
+__all__ = [
+    # Core
+    "CykaClient",
+    "Agent",
+    "AgentConfig",
+    "AgentResult",
+    "Browser",
+    "BrowserSession",
+    # Types
+    "ToolDefinition",
+    "ToolCall",
+    "ToolResult",
+    "ChatMessage",
+    "CompletionResult",
+    "TokenUsage",
+    "Plan",
+    "Step",
+    "StepLogEntry",
+    "PerceptionSnapshot",
+    "InteractiveElement",
+    "ProgressEvent",
+]