everpod-ai 0.1.0__tar.gz

everpod_ai-0.1.0/LICENSE

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

everpod_ai-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: everpod-ai
+Version: 0.1.0
+Summary: Official Python SDK for the Everpod API.
+Author-email: Everpod <support@everpod.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://everpod.ai
+Project-URL: Documentation, https://everpod.ai/docs/api
+Project-URL: Repository, https://github.com/everpod-ai/sdk-python
+Project-URL: Issues, https://github.com/everpod-ai/sdk-python/issues
+Keywords: everpod,ai-agents,agent-hosting,openclaw,mcp,sdk
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Everpod SDK for Python
+
+The official Python client for the [Everpod API](https://everpod.ai/docs/api).
+
+Everpod runs an AI agent on a pod: a private, always-on cloud computer of its own. A key lets an agent or an app you trust see your pods and start a new one for you, which you then pay for on everpod.ai. It can't pay, change or cancel a plan, delete anything, or open your agent's control panel.
+
+If you are connecting an agent such as Claude Code or Codex, you do not need this library: point it at Everpod's MCP server, as the [API reference](https://everpod.ai/docs/api) shows.
+
+## Install
+
+```
+pip install everpod-ai
+```
+
+Python 3.9 or later. No dependencies.
+
+## Use
+
+To make a key, open [everpod.ai/account/keys](https://everpod.ai/account/keys) and sign in with your email address and the code we send you. If you have no account yet, signing in makes one. Give the key to the library from an environment variable.
+
+```python
+import os
+
+from everpod_ai import Everpod
+
+everpod = Everpod(os.environ["EVERPOD_API_KEY"])
+
+# Start a pod under the name you want for its agent. Nothing is charged:
+# the pod stays unpaid until you open pay_url in a browser and pay there.
+pod = everpod.start_pod("Otto")
+print(pod["status"], pod["pay_url"])
+
+# The pods on your account, oldest first.
+pods = everpod.list_pods()
+
+# One pod by its id: how to check whether it has been paid for, and whether it is ready.
+same = everpod.get_pod(pod["id"])
+```
+
+While your account has an unpaid pod, starting another returns that same pod, renamed if the name differs.
+
+A pod's fields and what each status means are in the [API reference](https://everpod.ai/docs/api).
+
+## When a request is refused
+
+A refusal raises an `EverpodError`. Its `message` is the API's own sentence, which says what happened and what to do next; `code` and `status` are the refusal's.
+
+```python
+from everpod_ai import EverpodError
+
+try:
+    everpod.get_pod(pod_id)
+except EverpodError as error:
+    print(error.code, error.status, error.message)
+```
+
+## Questions
+
+[support@everpod.ai](mailto:support@everpod.ai)
+
+## License
+
+MIT

everpod_ai-0.1.0/README.md

@@ -0,0 +1,63 @@
+# Everpod SDK for Python
+
+The official Python client for the [Everpod API](https://everpod.ai/docs/api).
+
+Everpod runs an AI agent on a pod: a private, always-on cloud computer of its own. A key lets an agent or an app you trust see your pods and start a new one for you, which you then pay for on everpod.ai. It can't pay, change or cancel a plan, delete anything, or open your agent's control panel.
+
+If you are connecting an agent such as Claude Code or Codex, you do not need this library: point it at Everpod's MCP server, as the [API reference](https://everpod.ai/docs/api) shows.
+
+## Install
+
+```
+pip install everpod-ai
+```
+
+Python 3.9 or later. No dependencies.
+
+## Use
+
+To make a key, open [everpod.ai/account/keys](https://everpod.ai/account/keys) and sign in with your email address and the code we send you. If you have no account yet, signing in makes one. Give the key to the library from an environment variable.
+
+```python
+import os
+
+from everpod_ai import Everpod
+
+everpod = Everpod(os.environ["EVERPOD_API_KEY"])
+
+# Start a pod under the name you want for its agent. Nothing is charged:
+# the pod stays unpaid until you open pay_url in a browser and pay there.
+pod = everpod.start_pod("Otto")
+print(pod["status"], pod["pay_url"])
+
+# The pods on your account, oldest first.
+pods = everpod.list_pods()
+
+# One pod by its id: how to check whether it has been paid for, and whether it is ready.
+same = everpod.get_pod(pod["id"])
+```
+
+While your account has an unpaid pod, starting another returns that same pod, renamed if the name differs.
+
+A pod's fields and what each status means are in the [API reference](https://everpod.ai/docs/api).
+
+## When a request is refused
+
+A refusal raises an `EverpodError`. Its `message` is the API's own sentence, which says what happened and what to do next; `code` and `status` are the refusal's.
+
+```python
+from everpod_ai import EverpodError
+
+try:
+    everpod.get_pod(pod_id)
+except EverpodError as error:
+    print(error.code, error.status, error.message)
+```
+
+## Questions
+
+[support@everpod.ai](mailto:support@everpod.ai)
+
+## License
+
+MIT

everpod_ai-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=77.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "everpod-ai"
+version = "0.1.0"
+description = "Official Python SDK for the Everpod API."
+readme = "README.md"
+authors = [
+    { name = "Everpod", email = "support@everpod.ai" },
+]
+license = "MIT"
+requires-python = ">=3.9"
+dependencies = []
+keywords = ["everpod", "ai-agents", "agent-hosting", "openclaw", "mcp", "sdk"]
+
+[project.urls]
+Homepage = "https://everpod.ai"
+Documentation = "https://everpod.ai/docs/api"
+Repository = "https://github.com/everpod-ai/sdk-python"
+Issues = "https://github.com/everpod-ai/sdk-python/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+everpod_ai = ["py.typed"]

everpod_ai-0.1.0/setup.cfg

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

everpod_ai-0.1.0/src/everpod_ai/__init__.py

@@ -0,0 +1,124 @@
+"""The Everpod API's Python client: the operations a key can call
+(https://everpod.ai/docs/api) and nothing else. Standard library only.
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any, Callable, List, Optional, TypedDict
+
+__version__ = "0.1.0"
+__all__ = ["Everpod", "EverpodError", "Pod", "PodSubscription", "__version__"]
+
+DEFAULT_BASE_URL = "https://everpod.ai"
+
+
+class PodSubscription(TypedDict):
+    status: str
+    current_period_end: Optional[str]  # when the paid period ends
+    cancel_at_period_end: bool  # whether the subscription is set to end then
+
+
+class Pod(TypedDict):
+    """A pod. What each status means: https://everpod.ai/docs/api"""
+
+    id: str
+    name: str  # the name of the pod's agent
+    harness: str  # the agent software the pod runs
+    status: str  # awaiting_payment, building, setup_delayed, ready, needs_attention, stopped
+    created_at: str
+    url: Optional[str]  # the pod's page on everpod.ai; None until the pod is paid for
+    pay_url: Optional[str]  # where the pod's owner pays, while the status is awaiting_payment
+    plan: Optional[str]  # None until the pod is paid for
+    subscription: Optional[PodSubscription]  # None until the pod is paid for
+
+
+class EverpodError(Exception):
+    """What the API refused, or what stopped the request reaching it.
+
+    ``message`` is the API's own sentence, written to be passed on to the
+    account's owner; ``code`` and ``status`` are the refusal's
+    (https://everpod.ai/docs/api).
+    """
+
+    def __init__(self, message: str, *, code: Optional[str] = None, status: Optional[int] = None):
+        super().__init__(message)
+        self.message = message
+        self.code = code
+        self.status = status
+
+
+class Everpod:
+    def __init__(
+        self,
+        api_key: str,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = 30.0,
+        opener: Optional[Callable[..., Any]] = None,
+    ):
+        if not api_key:
+            raise EverpodError(
+                "An Everpod API key is needed: Everpod(api_key=...). The account's owner "
+                "makes one at https://everpod.ai/account/keys.",
+                code="missing_api_key",
+            )
+        self._api_key = api_key
+        self._base_url = base_url.rstrip("/")
+        self._timeout = timeout
+        self._open = opener or urllib.request.urlopen
+
+    def list_pods(self) -> List[Pod]:
+        """The pods on the account, oldest first."""
+        return self._request("GET", "/pods")["pods"]
+
+    def get_pod(self, pod_id: str) -> Pod:
+        """One pod by its id."""
+        return self._request("GET", "/pods/" + urllib.parse.quote(str(pod_id), safe=""))["pod"]
+
+    def start_pod(self, name: str) -> Pod:
+        """Start a pod under the name its owner wants for their agent.
+
+        Nothing is charged: the pod stays unpaid until its owner pays at
+        ``pay_url``.
+        """
+        return self._request("POST", "/pods", {"name": name})["pod"]
+
+    def _request(self, method: str, path: str, body: Optional[dict] = None) -> Any:
+        headers = {
+            "Authorization": f"Bearer {self._api_key}",
+            "Accept": "application/json",
+            "User-Agent": f"everpod-sdk-python/{__version__}",
+        }
+        data = None
+        if body is not None:
+            headers["Content-Type"] = "application/json"
+            data = json.dumps(body).encode("utf-8")
+        request = urllib.request.Request(
+            f"{self._base_url}/api/v1{path}", data=data, headers=headers, method=method
+        )
+        try:
+            with self._open(request, timeout=self._timeout) as response:
+                return json.loads(response.read().decode("utf-8"))
+        except urllib.error.HTTPError as refused:
+            try:
+                error = json.loads(refused.read().decode("utf-8")).get("error")
+            except Exception:
+                error = None
+            # The API's refusals carry a code and a sentence; anything else that
+            # answers in its place is reported by its status alone.
+            if not isinstance(error, dict):
+                error = {}
+            raise EverpodError(
+                error.get("message") or f"Everpod answered {refused.code}.",
+                code=error.get("code") or "http_error",
+                status=refused.code,
+            ) from None
+        except (urllib.error.URLError, OSError) as failed:
+            reason = getattr(failed, "reason", failed)
+            raise EverpodError(
+                f"The request to Everpod did not complete: {reason}", code="network_error"
+            ) from failed

everpod_ai-0.1.0/src/everpod_ai/py.typed

@@ -0,0 +1 @@
+

everpod_ai-0.1.0/src/everpod_ai.egg-info/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: everpod-ai
+Version: 0.1.0
+Summary: Official Python SDK for the Everpod API.
+Author-email: Everpod <support@everpod.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://everpod.ai
+Project-URL: Documentation, https://everpod.ai/docs/api
+Project-URL: Repository, https://github.com/everpod-ai/sdk-python
+Project-URL: Issues, https://github.com/everpod-ai/sdk-python/issues
+Keywords: everpod,ai-agents,agent-hosting,openclaw,mcp,sdk
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Everpod SDK for Python
+
+The official Python client for the [Everpod API](https://everpod.ai/docs/api).
+
+Everpod runs an AI agent on a pod: a private, always-on cloud computer of its own. A key lets an agent or an app you trust see your pods and start a new one for you, which you then pay for on everpod.ai. It can't pay, change or cancel a plan, delete anything, or open your agent's control panel.
+
+If you are connecting an agent such as Claude Code or Codex, you do not need this library: point it at Everpod's MCP server, as the [API reference](https://everpod.ai/docs/api) shows.
+
+## Install
+
+```
+pip install everpod-ai
+```
+
+Python 3.9 or later. No dependencies.
+
+## Use
+
+To make a key, open [everpod.ai/account/keys](https://everpod.ai/account/keys) and sign in with your email address and the code we send you. If you have no account yet, signing in makes one. Give the key to the library from an environment variable.
+
+```python
+import os
+
+from everpod_ai import Everpod
+
+everpod = Everpod(os.environ["EVERPOD_API_KEY"])
+
+# Start a pod under the name you want for its agent. Nothing is charged:
+# the pod stays unpaid until you open pay_url in a browser and pay there.
+pod = everpod.start_pod("Otto")
+print(pod["status"], pod["pay_url"])
+
+# The pods on your account, oldest first.
+pods = everpod.list_pods()
+
+# One pod by its id: how to check whether it has been paid for, and whether it is ready.
+same = everpod.get_pod(pod["id"])
+```
+
+While your account has an unpaid pod, starting another returns that same pod, renamed if the name differs.
+
+A pod's fields and what each status means are in the [API reference](https://everpod.ai/docs/api).
+
+## When a request is refused
+
+A refusal raises an `EverpodError`. Its `message` is the API's own sentence, which says what happened and what to do next; `code` and `status` are the refusal's.
+
+```python
+from everpod_ai import EverpodError
+
+try:
+    everpod.get_pod(pod_id)
+except EverpodError as error:
+    print(error.code, error.status, error.message)
+```
+
+## Questions
+
+[support@everpod.ai](mailto:support@everpod.ai)
+
+## License
+
+MIT

everpod_ai-0.1.0/src/everpod_ai.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/everpod_ai/__init__.py
+src/everpod_ai/py.typed
+src/everpod_ai.egg-info/PKG-INFO
+src/everpod_ai.egg-info/SOURCES.txt
+src/everpod_ai.egg-info/dependency_links.txt
+src/everpod_ai.egg-info/top_level.txt
+tests/test_client.py

everpod_ai-0.1.0/src/everpod_ai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

everpod_ai-0.1.0/src/everpod_ai.egg-info/top_level.txt

@@ -0,0 +1 @@
+everpod_ai

everpod_ai-0.1.0/tests/test_client.py

@@ -0,0 +1,136 @@
+"""Unit tests for the client: what it sends and how it reads what comes back,
+against an opener that answers from a script. Nothing here reaches a network.
+
+    python tests/test_client.py
+"""
+
+import io
+import json
+import os
+import sys
+import unittest
+import urllib.error
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
+
+from everpod_ai import Everpod, EverpodError, __version__  # noqa: E402
+
+POD = {
+    "id": "5f0c1a52-8f1e-4d0b-9a57-3f6f2f7c1e9a",
+    "name": "Otto",
+    "harness": "openclaw",
+    "status": "awaiting_payment",
+    "created_at": "2026-10-03T09:12:44.512345+00:00",
+    "url": None,
+    "pay_url": "https://everpod.ai/create?pod=5f0c1a52-8f1e-4d0b-9a57-3f6f2f7c1e9a",
+    "plan": None,
+    "subscription": None,
+}
+
+
+class Answer(io.BytesIO):
+    """A response the client can use as a context manager."""
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *exc):
+        return False
+
+
+class Scripted:
+    """An opener that records each request and answers ``status`` with ``body``."""
+
+    def __init__(self, status, body):
+        self.status = status
+        self.raw = body if isinstance(body, bytes) else json.dumps(body).encode("utf-8")
+        self.calls = []
+
+    def __call__(self, request, timeout=None):
+        self.calls.append((request, timeout))
+        if self.status >= 400:
+            raise urllib.error.HTTPError(
+                request.full_url, self.status, "refused", hdrs=None, fp=io.BytesIO(self.raw)
+            )
+        return Answer(self.raw)
+
+
+def client(opener, **extra):
+    return Everpod("everpod_test", opener=opener, **extra)
+
+
+class ClientTests(unittest.TestCase):
+    def test_no_key_says_where_a_key_is_made(self):
+        with self.assertRaises(EverpodError) as raised:
+            Everpod("")
+        self.assertEqual(raised.exception.code, "missing_api_key")
+        self.assertIn("/account/keys", raised.exception.message)
+
+    def test_list_pods_asks_the_list_route_with_the_key(self):
+        opener = Scripted(200, {"pods": [POD]})
+        self.assertEqual(client(opener).list_pods(), [POD])
+        request, timeout = opener.calls[0]
+        self.assertEqual(request.full_url, "https://everpod.ai/api/v1/pods")
+        self.assertEqual(request.get_method(), "GET")
+        self.assertEqual(request.get_header("Authorization"), "Bearer everpod_test")
+        self.assertEqual(request.get_header("User-agent"), f"everpod-sdk-python/{__version__}")
+        self.assertIsNone(request.data)
+        self.assertEqual(timeout, 30.0)
+
+    def test_get_pod_escapes_its_id(self):
+        opener = Scripted(200, {"pod": POD})
+        self.assertEqual(client(opener).get_pod(POD["id"]), POD)
+        self.assertEqual(opener.calls[0][0].full_url, f"https://everpod.ai/api/v1/pods/{POD['id']}")
+        client(opener).get_pod("a/b")
+        self.assertEqual(opener.calls[1][0].full_url, "https://everpod.ai/api/v1/pods/a%2Fb")
+
+    def test_start_pod_posts_the_name_as_json(self):
+        opener = Scripted(201, {"pod": POD})
+        self.assertEqual(client(opener).start_pod("Otto"), POD)
+        request = opener.calls[0][0]
+        self.assertEqual(request.get_method(), "POST")
+        self.assertEqual(request.get_header("Content-type"), "application/json")
+        self.assertEqual(json.loads(request.data.decode("utf-8")), {"name": "Otto"})
+
+    def test_a_base_url_with_a_trailing_slash(self):
+        opener = Scripted(200, {"pods": []})
+        client(opener, base_url="http://localhost:3111/").list_pods()
+        self.assertEqual(opener.calls[0][0].full_url, "http://localhost:3111/api/v1/pods")
+
+    def test_a_refusal_carries_the_apis_code_status_and_sentence(self):
+        opener = Scripted(
+            404, {"error": {"code": "not_found", "message": "No pod with that id on this account."}}
+        )
+        with self.assertRaises(EverpodError) as raised:
+            client(opener).get_pod("nope")
+        self.assertEqual(raised.exception.code, "not_found")
+        self.assertEqual(raised.exception.status, 404)
+        self.assertEqual(raised.exception.message, "No pod with that id on this account.")
+
+    def test_an_answer_that_is_not_the_apis_json_still_says_its_status(self):
+        opener = Scripted(502, b"<html>bad gateway</html>")
+        with self.assertRaises(EverpodError) as raised:
+            client(opener).list_pods()
+        self.assertEqual(raised.exception.code, "http_error")
+        self.assertEqual(raised.exception.status, 502)
+        self.assertIn("502", raised.exception.message)
+
+    def test_a_json_answer_of_another_shape_still_says_its_status(self):
+        opener = Scripted(403, {"ok": False, "error": "forbidden"})
+        with self.assertRaises(EverpodError) as raised:
+            client(opener).list_pods()
+        self.assertEqual(raised.exception.code, "http_error")
+        self.assertEqual(raised.exception.status, 403)
+
+    def test_a_request_that_never_completes_is_a_network_error(self):
+        def failing(request, timeout=None):
+            raise urllib.error.URLError("no route to host")
+
+        with self.assertRaises(EverpodError) as raised:
+            client(failing).list_pods()
+        self.assertEqual(raised.exception.code, "network_error")
+        self.assertIsInstance(raised.exception.__cause__, urllib.error.URLError)
+
+
+if __name__ == "__main__":
+    unittest.main()