aetus 1.0.0__tar.gz

aetus-1.0.0/LICENSE

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

aetus-1.0.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: aetus
+Version: 1.0.0
+Summary: Reduce your AI bill up to 78% — context compression for OpenAI and Anthropic.
+License-Expression: MIT
+Project-URL: Homepage, https://aetus.ai
+Project-URL: Documentation, https://aetus.ai/docs
+Project-URL: Repository, https://github.com/aetus-ai/aetus-python
+Keywords: openai,anthropic,llm,compression,tokens,cost
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.20; extra == "anthropic"
+Provides-Extra: all
+Requires-Dist: openai>=1.0; extra == "all"
+Requires-Dist: anthropic>=0.20; extra == "all"
+Dynamic: license-file
+
+# aetus
+
+Python SDK for Aetus context compression.
+
+## Install
+
+```bash
+pip install aetus
+```
+
+## Usage
+
+```python
+from aetus import Aetus
+
+aetus = Aetus()
+result = aetus.compress(
+    messages,
+    query="What should the model answer next?",
+)
+
+print(result["compressed"])
+print(result["savings_pct"])
+```
+
+Set `AETUS_API_KEY` to a key created at
+[aetus.vercel.app/dashboard/keys](https://aetus.vercel.app/dashboard/keys).
+
+Pass `base_url` to override the hosted API.

aetus-1.0.0/README.md

@@ -0,0 +1,29 @@
+# aetus
+
+Python SDK for Aetus context compression.
+
+## Install
+
+```bash
+pip install aetus
+```
+
+## Usage
+
+```python
+from aetus import Aetus
+
+aetus = Aetus()
+result = aetus.compress(
+    messages,
+    query="What should the model answer next?",
+)
+
+print(result["compressed"])
+print(result["savings_pct"])
+```
+
+Set `AETUS_API_KEY` to a key created at
+[aetus.vercel.app/dashboard/keys](https://aetus.vercel.app/dashboard/keys).
+
+Pass `base_url` to override the hosted API.

aetus-1.0.0/aetus/__init__.py

@@ -0,0 +1,198 @@
+"""
+aetus — Python SDK for Aetus context compression.
+
+Quickstart (proxy — zero other code changes):
+    from aetus import Aetus
+    import openai
+
+    aetus  = Aetus("aet_live_...")
+    client = aetus.openai("sk-openai-...")   # drop-in OpenAI client
+    # Every call is now auto-compressed. That's it.
+
+Quickstart (direct compress):
+    compressed = aetus.compress(messages, query=current_message)
+    response   = openai_client.chat.completions.create(
+        model="gpt-4.1",
+        messages=compressed["compressed"]
+    )
+
+Monitoring:
+    stats = aetus.usage()    # tokens saved, credits used, sessions
+"""
+
+from __future__ import annotations
+
+import os
+import urllib.request
+import urllib.error
+import json
+from typing import Optional
+
+
+BASE_URL = "https://aetus-production.up.railway.app"
+
+
+class AetusError(Exception):
+    def __init__(self, message: str, status_code: int = 0):
+        super().__init__(message)
+        self.status_code = status_code
+
+
+class Aetus:
+    """
+    Aetus client. Instantiate once, use everywhere.
+
+        aetus = Aetus(api_key="aet_live_...")
+    """
+
+    def __init__(
+        self,
+        api_key:  Optional[str] = None,
+        base_url: str           = BASE_URL,
+    ):
+        self.api_key  = api_key or os.environ.get("AETUS_API_KEY") or ""
+        self.base_url = base_url.rstrip("/")
+
+        if not self.api_key:
+            raise AetusError(
+                "No API key provided. Pass api_key= or set AETUS_API_KEY env var. "
+                "Get one free at aetus.ai/dashboard"
+            )
+
+    # ── Core: compress ────────────────────────────────────────────────────────
+
+    def compress(
+        self,
+        messages:           list[dict],
+        query:              str   = "",
+        model:              str   = "gpt-4.1",
+        always_keep_last_n: int   = 1,
+        recency_factor:     float = 0.85,
+    ) -> dict:
+        """
+        Compress message history. Returns same dict shape as /compress endpoint.
+
+        compressed["compressed"]   → drop-in replacement for your messages list
+        compressed["savings_pct"]  → e.g. 91.4
+        compressed["tokens_saved"] → e.g. 24832
+        """
+        return self._post("/compress", {
+            "messages":           messages,
+            "query":              query,
+            "model":              model,
+            "always_keep_last_n": always_keep_last_n,
+            "recency_factor":     recency_factor,
+        })
+
+    # ── Proxy: drop-in OpenAI client ──────────────────────────────────────────
+
+    def openai(self, provider_key: Optional[str] = None) -> "object":
+        """
+        Returns an OpenAI client pre-configured to route through Aetus.
+        Every chat.completions.create() call is auto-compressed.
+
+            client = aetus.openai("sk-...")
+            resp   = client.chat.completions.create(model="gpt-4.1", messages=msgs)
+            # resp.aetus.tokens_saved is available on the response object
+        """
+        try:
+            import openai as _openai
+        except ImportError:
+            raise AetusError("openai package not installed. Run: pip install openai")
+
+        pk = provider_key or os.environ.get("OPENAI_API_KEY") or ""
+        if not pk:
+            raise AetusError(
+                "No provider key. Pass provider_key= or set OPENAI_API_KEY env var."
+            )
+
+        return _openai.OpenAI(
+            api_key         = pk,
+            base_url        = f"{self.base_url}/v1",
+            default_headers = {"X-Aetus-Key": self.api_key},
+        )
+
+    def async_openai(self, provider_key: Optional[str] = None) -> "object":
+        """Async version of openai()."""
+        try:
+            import openai as _openai
+        except ImportError:
+            raise AetusError("openai package not installed. Run: pip install openai")
+
+        pk = provider_key or os.environ.get("OPENAI_API_KEY") or ""
+        return _openai.AsyncOpenAI(
+            api_key         = pk,
+            base_url        = f"{self.base_url}/v1",
+            default_headers = {"X-Aetus-Key": self.api_key},
+        )
+
+    def anthropic(self, provider_key: Optional[str] = None) -> "object":
+        """
+        Returns an Anthropic client routed through Aetus.
+
+            client = aetus.anthropic("sk-ant-...")
+            resp   = client.messages.create(model="claude-sonnet-4-5", ...)
+        """
+        try:
+            import anthropic as _anthropic
+        except ImportError:
+            raise AetusError("anthropic package not installed. Run: pip install anthropic")
+
+        pk = provider_key or os.environ.get("ANTHROPIC_API_KEY") or ""
+        return _anthropic.Anthropic(
+            api_key      = pk,
+            base_url     = f"{self.base_url}/v1",
+            default_headers = {"X-Aetus-Key": self.api_key},
+        )
+
+    # ── Monitoring ────────────────────────────────────────────────────────────
+
+    def usage(self, days: int = 7) -> dict:
+        """Return usage stats: tokens saved, credits used, requests."""
+        return self._get(f"/billing/usage?days={days}")
+
+    def credits(self) -> dict:
+        """Return current credit balance."""
+        return self._get("/billing/credits")
+
+    def me(self) -> dict:
+        """Return org info, plan, limits."""
+        return self._get("/auth/me")
+
+    # ── HTTP internals ────────────────────────────────────────────────────────
+
+    def _post(self, path: str, body: dict) -> dict:
+        data    = json.dumps(body).encode()
+        headers = {
+            "Content-Type":  "application/json",
+            "Authorization": f"Bearer {self.api_key}",
+        }
+        req = urllib.request.Request(
+            f"{self.base_url}{path}", data=data, headers=headers, method="POST"
+        )
+        try:
+            with urllib.request.urlopen(req) as resp:
+                return json.loads(resp.read())
+        except urllib.error.HTTPError as e:
+            body_text = e.read().decode(errors="replace")
+            try:
+                detail = json.loads(body_text).get("detail", body_text)
+            except Exception:
+                detail = body_text
+            raise AetusError(detail, e.code)
+
+    def _get(self, path: str) -> dict:
+        headers = {"Authorization": f"Bearer {self.api_key}"}
+        req = urllib.request.Request(
+            f"{self.base_url}{path}", headers=headers, method="GET"
+        )
+        try:
+            with urllib.request.urlopen(req) as resp:
+                return json.loads(resp.read())
+        except urllib.error.HTTPError as e:
+            body_text = e.read().decode(errors="replace")
+            try:
+                detail = json.loads(body_text).get("detail", body_text)
+            except Exception:
+                detail = body_text
+            raise AetusError(detail, e.code)

aetus-1.0.0/aetus.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: aetus
+Version: 1.0.0
+Summary: Reduce your AI bill up to 78% — context compression for OpenAI and Anthropic.
+License-Expression: MIT
+Project-URL: Homepage, https://aetus.ai
+Project-URL: Documentation, https://aetus.ai/docs
+Project-URL: Repository, https://github.com/aetus-ai/aetus-python
+Keywords: openai,anthropic,llm,compression,tokens,cost
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.20; extra == "anthropic"
+Provides-Extra: all
+Requires-Dist: openai>=1.0; extra == "all"
+Requires-Dist: anthropic>=0.20; extra == "all"
+Dynamic: license-file
+
+# aetus
+
+Python SDK for Aetus context compression.
+
+## Install
+
+```bash
+pip install aetus
+```
+
+## Usage
+
+```python
+from aetus import Aetus
+
+aetus = Aetus()
+result = aetus.compress(
+    messages,
+    query="What should the model answer next?",
+)
+
+print(result["compressed"])
+print(result["savings_pct"])
+```
+
+Set `AETUS_API_KEY` to a key created at
+[aetus.vercel.app/dashboard/keys](https://aetus.vercel.app/dashboard/keys).
+
+Pass `base_url` to override the hosted API.

aetus-1.0.0/aetus.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+aetus/__init__.py
+aetus.egg-info/PKG-INFO
+aetus.egg-info/SOURCES.txt
+aetus.egg-info/dependency_links.txt
+aetus.egg-info/requires.txt
+aetus.egg-info/top_level.txt

aetus-1.0.0/aetus.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aetus-1.0.0/aetus.egg-info/requires.txt

@@ -0,0 +1,10 @@
+
+[all]
+openai>=1.0
+anthropic>=0.20
+
+[anthropic]
+anthropic>=0.20
+
+[openai]
+openai>=1.0

aetus-1.0.0/aetus.egg-info/top_level.txt

@@ -0,0 +1 @@
+aetus

aetus-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name            = "aetus"
+version         = "1.0.0"
+description     = "Reduce your AI bill up to 78% — context compression for OpenAI and Anthropic."
+readme          = "README.md"
+license         = "MIT"
+requires-python = ">=3.9"
+keywords        = ["openai", "anthropic", "llm", "compression", "tokens", "cost"]
+classifiers     = [
+    "Programming Language :: Python :: 3",
+]
+
+[project.optional-dependencies]
+openai    = ["openai>=1.0"]
+anthropic = ["anthropic>=0.20"]
+all       = ["openai>=1.0", "anthropic>=0.20"]
+
+[project.urls]
+Homepage      = "https://aetus.ai"
+Documentation = "https://aetus.ai/docs"
+Repository    = "https://github.com/aetus-ai/aetus-python"

aetus-1.0.0/setup.cfg

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