asteroid-odyssey 1.3.12__py3-none-any.whl → 1.6.0__py3-none-any.whl

asteroid_odyssey/{agents_v1_gen/models/country_code.py → models/agents_profile_country_code.py}

@@ -1,11 +1,11 @@
 # coding: utf-8
 
 """
-    Asteroid Agents API
+    Agent Service
 
-    Version 1 of the Asteroid Agents API
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
 
-    The version of the OpenAPI document: v1.0.0
+    The version of the OpenAPI document: v1
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -18,7 +18,7 @@ from enum import Enum
 from typing_extensions import Self
 
 
-class CountryCode(str, Enum):
+class AgentsProfileCountryCode(str, Enum):
     """
     Two-letter country code for proxy location
     """
@@ -38,7 +38,7 @@ class CountryCode(str, Enum):
 
     @classmethod
     def from_json(cls, json_str: str) -> Self:
-        """Create an instance of CountryCode from a JSON string"""
+        """Create an instance of AgentsProfileCountryCode from a JSON string"""
         return cls(json.loads(json_str))
 
 

asteroid_odyssey/{agents_v1_gen/models/create_agent_profile_request.py → models/agents_profile_create_agent_profile_request.py}

@@ -1,11 +1,11 @@
 # coding: utf-8
 
 """
-    Asteroid Agents API
+    Agent Service
 
-    Version 1 of the Asteroid Agents API
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
 
-    The version of the OpenAPI document: v1.0.0
+    The version of the OpenAPI document: v1
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -20,28 +20,31 @@ import json
 from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictStr
 from typing import Any, ClassVar, Dict, List, Optional
 from typing_extensions import Annotated
-from asteroid_odyssey.agents_v1_gen.models.cookie import Cookie
-from asteroid_odyssey.agents_v1_gen.models.country_code import CountryCode
-from asteroid_odyssey.agents_v1_gen.models.credential import Credential
-from asteroid_odyssey.agents_v1_gen.models.proxy_type import ProxyType
+from asteroid_odyssey.models.agents_profile_cookie import AgentsProfileCookie
+from asteroid_odyssey.models.agents_profile_country_code import AgentsProfileCountryCode
+from asteroid_odyssey.models.agents_profile_credential import AgentsProfileCredential
+from asteroid_odyssey.models.agents_profile_operating_system import AgentsProfileOperatingSystem
+from asteroid_odyssey.models.agents_profile_proxy_type import AgentsProfileProxyType
 from typing import Optional, Set
 from typing_extensions import Self
 
-class CreateAgentProfileRequest(BaseModel):
+class AgentsProfileCreateAgentProfileRequest(BaseModel):
     """
-    CreateAgentProfileRequest
+    Request to create a new agent profile
     """ # noqa: E501
     name: Annotated[str, Field(min_length=1, strict=True, max_length=255)] = Field(description="Name of the agent profile (must be unique within organization)")
     description: Annotated[str, Field(strict=True, max_length=1000)] = Field(description="Description of the agent profile")
-    organization_id: StrictStr = Field(description="The ID of the organization that the agent profile belongs to")
-    proxy_cc: CountryCode
-    proxy_type: ProxyType
-    captcha_solver_active: StrictBool = Field(description="Whether the captcha solver should be active for this profile")
-    sticky_ip: StrictBool = Field(description="Whether the same IP address should be used for all executions of this profile")
-    credentials: List[Credential] = Field(description="Optional list of credentials to create with the profile")
-    cookies: List[Cookie] = Field(description="Optional list of cookies to create with the profile")
-    extra_stealth: Optional[StrictBool] = Field(default=False, description="Whether to enable extra stealth for the profile")
-    __properties: ClassVar[List[str]] = ["name", "description", "organization_id", "proxy_cc", "proxy_type", "captcha_solver_active", "sticky_ip", "credentials", "cookies", "extra_stealth"]
+    organization_id: StrictStr = Field(description="The ID of the organization that the profile belongs to", alias="organizationId")
+    proxy_cc: Optional[AgentsProfileCountryCode] = Field(default=None, description="Country code for proxy location", alias="proxyCC")
+    proxy_type: Optional[AgentsProfileProxyType] = Field(default=None, description="Type of proxy to use", alias="proxyType")
+    captcha_solver_active: Optional[StrictBool] = Field(default=False, description="Whether the captcha solver should be active", alias="captchaSolverActive")
+    sticky_ip: Optional[StrictBool] = Field(default=False, description="Whether to use the same IP address for all executions", alias="stickyIP")
+    operating_system: Optional[AgentsProfileOperatingSystem] = Field(default=None, description="Operating system to emulate", alias="operatingSystem")
+    extra_stealth: Optional[StrictBool] = Field(default=False, description="Whether to enable extra stealth mode", alias="extraStealth")
+    cache_persistence: Optional[StrictBool] = Field(default=False, description="Whether to persist browser cache between sessions", alias="cachePersistence")
+    credentials: Optional[List[AgentsProfileCredential]] = Field(default=None, description="Initial credentials to create with the profile")
+    cookies: Optional[List[AgentsProfileCookie]] = Field(default=None, description="Initial cookies to create with the profile")
+    __properties: ClassVar[List[str]] = ["name", "description", "organizationId", "proxyCC", "proxyType", "captchaSolverActive", "stickyIP", "operatingSystem", "extraStealth", "cachePersistence", "credentials", "cookies"]
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -61,7 +64,7 @@ class CreateAgentProfileRequest(BaseModel):
 
     @classmethod
     def from_json(cls, json_str: str) -> Optional[Self]:
-        """Create an instance of CreateAgentProfileRequest from a JSON string"""
+        """Create an instance of AgentsProfileCreateAgentProfileRequest from a JSON string"""
         return cls.from_dict(json.loads(json_str))
 
     def to_dict(self) -> Dict[str, Any]:
@@ -100,7 +103,7 @@ class CreateAgentProfileRequest(BaseModel):
 
     @classmethod
     def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
-        """Create an instance of CreateAgentProfileRequest from a dict"""
+        """Create an instance of AgentsProfileCreateAgentProfileRequest from a dict"""
         if obj is None:
             return None
 
@@ -110,14 +113,16 @@ class CreateAgentProfileRequest(BaseModel):
         _obj = cls.model_validate({
             "name": obj.get("name"),
             "description": obj.get("description"),
-            "organization_id": obj.get("organization_id"),
-            "proxy_cc": obj.get("proxy_cc"),
-            "proxy_type": obj.get("proxy_type"),
-            "captcha_solver_active": obj.get("captcha_solver_active") if obj.get("captcha_solver_active") is not None else False,
-            "sticky_ip": obj.get("sticky_ip") if obj.get("sticky_ip") is not None else False,
-            "credentials": [Credential.from_dict(_item) for _item in obj["credentials"]] if obj.get("credentials") is not None else None,
-            "cookies": [Cookie.from_dict(_item) for _item in obj["cookies"]] if obj.get("cookies") is not None else None,
-            "extra_stealth": obj.get("extra_stealth") if obj.get("extra_stealth") is not None else False
+            "organizationId": obj.get("organizationId"),
+            "proxyCC": obj.get("proxyCC"),
+            "proxyType": obj.get("proxyType"),
+            "captchaSolverActive": obj.get("captchaSolverActive") if obj.get("captchaSolverActive") is not None else False,
+            "stickyIP": obj.get("stickyIP") if obj.get("stickyIP") is not None else False,
+            "operatingSystem": obj.get("operatingSystem"),
+            "extraStealth": obj.get("extraStealth") if obj.get("extraStealth") is not None else False,
+            "cachePersistence": obj.get("cachePersistence") if obj.get("cachePersistence") is not None else False,
+            "credentials": [AgentsProfileCredential.from_dict(_item) for _item in obj["credentials"]] if obj.get("credentials") is not None else None,
+            "cookies": [AgentsProfileCookie.from_dict(_item) for _item in obj["cookies"]] if obj.get("cookies") is not None else None
         })
         return _obj
 

asteroid_odyssey/{agents_v1_gen/models/credential.py → models/agents_profile_credential.py}

@@ -1,11 +1,11 @@
 # coding: utf-8
 
 """
-    Asteroid Agents API
+    Agent Service
 
-    Version 1 of the Asteroid Agents API
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
 
-    The version of the OpenAPI document: v1.0.0
+    The version of the OpenAPI document: v1
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -24,15 +24,15 @@ from typing_extensions import Annotated
 from typing import Optional, Set
 from typing_extensions import Self
 
-class Credential(BaseModel):
+class AgentsProfileCredential(BaseModel):
     """
-    Credential
+    A credential stored for an agent profile
     """ # noqa: E501
-    id: Optional[StrictStr] = Field(default=None, description="The unique identifier for this credential")
-    name: Annotated[str, Field(min_length=1, strict=True)] = Field(description="The credential name")
-    data: Annotated[str, Field(min_length=1, strict=True)] = Field(description="The encrypted credential")
-    created_at: Optional[datetime] = Field(default=None, description="When the credential was created")
-    __properties: ClassVar[List[str]] = ["id", "name", "data", "created_at"]
+    id: Optional[StrictStr] = Field(default=None, description="Unique identifier for the credential")
+    name: Annotated[str, Field(min_length=1, strict=True)] = Field(description="Display name for the credential (will be uppercased)")
+    data: Annotated[str, Field(min_length=1, strict=True)] = Field(description="The credential value (plaintext - will be encrypted server-side)")
+    created_at: Optional[datetime] = Field(default=None, description="When the credential was created", alias="createdAt")
+    __properties: ClassVar[List[str]] = ["id", "name", "data", "createdAt"]
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -52,7 +52,7 @@ class Credential(BaseModel):
 
     @classmethod
     def from_json(cls, json_str: str) -> Optional[Self]:
-        """Create an instance of Credential from a JSON string"""
+        """Create an instance of AgentsProfileCredential from a JSON string"""
         return cls.from_dict(json.loads(json_str))
 
     def to_dict(self) -> Dict[str, Any]:
@@ -77,7 +77,7 @@ class Credential(BaseModel):
 
     @classmethod
     def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
-        """Create an instance of Credential from a dict"""
+        """Create an instance of AgentsProfileCredential from a dict"""
         if obj is None:
             return None
 
@@ -88,7 +88,7 @@ class Credential(BaseModel):
             "id": obj.get("id"),
             "name": obj.get("name"),
             "data": obj.get("data"),
-            "created_at": obj.get("created_at")
+            "createdAt": obj.get("createdAt")
         })
         return _obj
 

asteroid_odyssey/models/agents_profile_operating_system.py

@@ -0,0 +1,37 @@
+# coding: utf-8
+
+"""
+    Agent Service
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class AgentsProfileOperatingSystem(str, Enum):
+    """
+    Operating system to emulate in the browser
+    """
+
+    """
+    allowed enum values
+    """
+    MACOS = 'macos'
+    WINDOWS = 'windows'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of AgentsProfileOperatingSystem from a JSON string"""
+        return cls(json.loads(json_str))
+
+

asteroid_odyssey/models/agents_profile_proxy_type.py

@@ -0,0 +1,38 @@
+# coding: utf-8
+
+"""
+    Agent Service
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class AgentsProfileProxyType(str, Enum):
+    """
+    Type of proxy to use for browser sessions
+    """
+
+    """
+    allowed enum values
+    """
+    BASIC = 'basic'
+    RESIDENTIAL = 'residential'
+    MOBILE = 'mobile'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of AgentsProfileProxyType from a JSON string"""
+        return cls(json.loads(json_str))
+
+

asteroid_odyssey/models/agents_profile_same_site.py

@@ -0,0 +1,38 @@
+# coding: utf-8
+
+"""
+    Agent Service
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class AgentsProfileSameSite(str, Enum):
+    """
+    SameSite attribute for cookies
+    """
+
+    """
+    allowed enum values
+    """
+    STRICT = 'Strict'
+    LAX = 'Lax'
+    NONE = 'None'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of AgentsProfileSameSite from a JSON string"""
+        return cls(json.loads(json_str))
+
+

asteroid_odyssey/models/agents_profile_sort_field.py

@@ -0,0 +1,38 @@
+# coding: utf-8
+
+"""
+    Agent Service
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class AgentsProfileSortField(str, Enum):
+    """
+    Available fields for sorting agent profiles
+    """
+
+    """
+    allowed enum values
+    """
+    NAME = 'name'
+    CREATED_AT = 'created_at'
+    UPDATED_AT = 'updated_at'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of AgentsProfileSortField from a JSON string"""
+        return cls(json.loads(json_str))
+
+

asteroid_odyssey/models/agents_profile_update_agent_profile_request.py

@@ -0,0 +1,129 @@
+# coding: utf-8
+
+"""
+    Agent Service
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from asteroid_odyssey.models.agents_profile_cookie import AgentsProfileCookie
+from asteroid_odyssey.models.agents_profile_country_code import AgentsProfileCountryCode
+from asteroid_odyssey.models.agents_profile_credential import AgentsProfileCredential
+from asteroid_odyssey.models.agents_profile_operating_system import AgentsProfileOperatingSystem
+from asteroid_odyssey.models.agents_profile_proxy_type import AgentsProfileProxyType
+from typing import Optional, Set
+from typing_extensions import Self
+
+class AgentsProfileUpdateAgentProfileRequest(BaseModel):
+    """
+    Request to update an existing agent profile
+    """ # noqa: E501
+    name: Optional[Annotated[str, Field(min_length=1, strict=True, max_length=255)]] = Field(default=None, description="New name for the profile")
+    description: Optional[Annotated[str, Field(strict=True, max_length=1000)]] = Field(default=None, description="New description for the profile")
+    proxy_cc: Optional[AgentsProfileCountryCode] = Field(default=None, description="Country code for proxy location", alias="proxyCC")
+    proxy_type: Optional[AgentsProfileProxyType] = Field(default=None, description="Type of proxy to use (set to empty string to disable proxy)", alias="proxyType")
+    captcha_solver_active: Optional[StrictBool] = Field(default=None, description="Whether the captcha solver should be active", alias="captchaSolverActive")
+    operating_system: Optional[AgentsProfileOperatingSystem] = Field(default=None, description="Operating system to emulate", alias="operatingSystem")
+    extra_stealth: Optional[StrictBool] = Field(default=None, description="Whether to enable extra stealth mode", alias="extraStealth")
+    cache_persistence: Optional[StrictBool] = Field(default=None, description="Whether to persist browser cache between sessions", alias="cachePersistence")
+    credentials_to_add: Optional[List[AgentsProfileCredential]] = Field(default=None, description="Credentials to add to the profile", alias="credentialsToAdd")
+    credentials_to_delete: Optional[List[StrictStr]] = Field(default=None, description="IDs of credentials to remove from the profile", alias="credentialsToDelete")
+    cookies_to_add: Optional[List[AgentsProfileCookie]] = Field(default=None, description="Cookies to add to the profile", alias="cookiesToAdd")
+    cookies_to_delete: Optional[List[StrictStr]] = Field(default=None, description="IDs of cookies to remove from the profile", alias="cookiesToDelete")
+    __properties: ClassVar[List[str]] = ["name", "description", "proxyCC", "proxyType", "captchaSolverActive", "operatingSystem", "extraStealth", "cachePersistence", "credentialsToAdd", "credentialsToDelete", "cookiesToAdd", "cookiesToDelete"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of AgentsProfileUpdateAgentProfileRequest from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in credentials_to_add (list)
+        _items = []
+        if self.credentials_to_add:
+            for _item_credentials_to_add in self.credentials_to_add:
+                if _item_credentials_to_add:
+                    _items.append(_item_credentials_to_add.to_dict())
+            _dict['credentialsToAdd'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in cookies_to_add (list)
+        _items = []
+        if self.cookies_to_add:
+            for _item_cookies_to_add in self.cookies_to_add:
+                if _item_cookies_to_add:
+                    _items.append(_item_cookies_to_add.to_dict())
+            _dict['cookiesToAdd'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of AgentsProfileUpdateAgentProfileRequest from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "name": obj.get("name"),
+            "description": obj.get("description"),
+            "proxyCC": obj.get("proxyCC"),
+            "proxyType": obj.get("proxyType"),
+            "captchaSolverActive": obj.get("captchaSolverActive"),
+            "operatingSystem": obj.get("operatingSystem"),
+            "extraStealth": obj.get("extraStealth"),
+            "cachePersistence": obj.get("cachePersistence"),
+            "credentialsToAdd": [AgentsProfileCredential.from_dict(_item) for _item in obj["credentialsToAdd"]] if obj.get("credentialsToAdd") is not None else None,
+            "credentialsToDelete": obj.get("credentialsToDelete"),
+            "cookiesToAdd": [AgentsProfileCookie.from_dict(_item) for _item in obj["cookiesToAdd"]] if obj.get("cookiesToAdd") is not None else None,
+            "cookiesToDelete": obj.get("cookiesToDelete")
+        })
+        return _obj
+
+

asteroid_odyssey/{agents_v2_gen/models → models}/executions_list200_response.py

@@ -19,7 +19,7 @@ import json
 
 from pydantic import BaseModel, ConfigDict, Field, StrictInt
 from typing import Any, ClassVar, Dict, List
-from asteroid_odyssey.agents_v2_gen.models.agents_execution_list_item import AgentsExecutionListItem
+from asteroid_odyssey.models.agents_execution_list_item import AgentsExecutionListItem
 from typing import Optional, Set
 from typing_extensions import Self
 

asteroid_odyssey/{agents_v2_gen/rest.py → rest.py}

@@ -19,7 +19,7 @@ import ssl
 
 import urllib3
 
-from asteroid_odyssey.agents_v2_gen.exceptions import ApiException, ApiValueError
+from asteroid_odyssey.exceptions import ApiException, ApiValueError
 
 SUPPORTED_SOCKS_PROXIES = {"socks5", "socks5h", "socks4", "socks4a"}
 RESTResponseType = urllib3.HTTPResponse
@@ -76,6 +76,7 @@ class RESTClientObject:
             "ca_certs": configuration.ssl_ca_cert,
             "cert_file": configuration.cert_file,
             "key_file": configuration.key_file,
+            "ca_cert_data": configuration.ca_cert_data,
         }
         if configuration.assert_hostname is not None:
             pool_args['assert_hostname'] = (

asteroid_odyssey-1.6.0.dist-info/METADATA

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: asteroid-odyssey
+Version: 1.6.0
+Summary: Python SDK for the Asteroid Agents API
+Author-email: Asteroid <founders@asteroid.com>
+License-Expression: MIT
+Project-URL: Repository, https://github.com/asteroidai/agents
+Project-URL: Homepage, https://asteroid.ai
+Project-URL: Documentation, https://docs.asteroid.ai
+Keywords: OpenAPI,Asteroid Agents API,browser automation,AI agents
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2
+Requires-Dist: typing-extensions>=4.7.1
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.2.1; extra == "dev"
+Requires-Dist: pytest-cov>=2.8.1; extra == "dev"
+Requires-Dist: flake8>=4.0.0; extra == "dev"
+Requires-Dist: mypy>=1.5; extra == "dev"
+
+# Asteroid Odyssey Python SDK
+
+Python SDK for the Asteroid Agents API.
+
+## Installation
+
+```bash
+pip install asteroid-odyssey
+```
+
+## Usage
+
+```python
+from asteroid_odyssey import ApiClient, Configuration, ExecutionApi
+
+# Configure the client
+config = Configuration(
+    host="https://odyssey.asteroid.ai/agents/v2",
+    api_key={"ApiKeyAuth": "your-api-key"}
+)
+
+client = ApiClient(config)
+execution_api = ExecutionApi(client)
+
+# Execute an agent
+response = execution_api.agent_execute_post(
+    agent_id="your-agent-id",
+    agents_agent_execute_agent_request={"dynamicData": {"input": "value"}}
+)
+print(f"Execution ID: {response.execution_id}")
+```
+
+## Documentation
+
+See [docs.asteroid.ai](https://docs.asteroid.ai) for full documentation.
+