kodari 1.0.0__tar.gz

kodari-1.0.0/.idea/.gitignore

@@ -0,0 +1,5 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/

kodari-1.0.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

kodari-1.0.0/.idea/kodaripython.iml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="Python 3.13 (kodaripython)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

kodari-1.0.0/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.13 (kodaripython)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.13 (kodaripython)" project-jdk-type="Python SDK" />
+</project>

kodari-1.0.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/kodaripython.iml" filepath="$PROJECT_DIR$/.idea/kodaripython.iml" />
+    </modules>
+  </component>
+</project>

kodari-1.0.0/.idea/workspace.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="ef19ca08-3230-4d7f-9a7b-462908395666" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 5
+}]]></component>
+  <component name="ProjectId" id="3BcQjIqEAu0J4IWeTPoXMrGq6xw" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
+    "ignore.virus.scanning.warn.message": "true"
+  }
+}]]></component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-python-sdk-164cda30dcd9-0af03a5fa574-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-252.26830.99" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="ef19ca08-3230-4d7f-9a7b-462908395666" name="Changes" comment="" />
+      <created>1774786011668</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1774786011668</updated>
+    </task>
+    <servers />
+  </component>
+</project>

kodari-1.0.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: kodari
+Version: 1.0.0
+Summary: Official Python SDK for the Kodari API
+Project-URL: Homepage, https://kodari.ai
+Project-URL: Repository, https://github.com/kodari-ai/kodaripython
+Author-email: Kodari <support@kodari.ai>
+License-Expression: MIT
+Keywords: ai,api,kodari,moderation
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.28.0
+Description-Content-Type: text/markdown
+
+# kodaripython
+
+Official Python SDK for the [Kodari API](https://kodari.ai). Fully async, built on httpx.
+
+## Installation
+
+```bash
+pip install kodari
+```
+
+## Quick Start
+
+Get your API key at [kodari.ai/api-keys](https://kodari.ai/api-keys).
+
+```python
+import asyncio
+from kodari import KodariClient, KodariCredentials
+
+async def main():
+    async with KodariClient(KodariCredentials("kod-your-api-key")) as client:
+        result = await client.moderate("hello everyone")
+
+        if not result.safe:
+            print(f"Flagged: {result.category}")  # toxicity, threat, doxxing, advertising, spam
+            print(f"Severity: {result.severity}")  # low, medium, high
+
+asyncio.run(main())
+```
+
+## Moderation
+
+Multilingual chat moderation AI that classifies messages for toxicity, threats, doxxing, spam, and advertising.
+
+```python
+result = await client.moderate("some message")
+
+result.safe          # True/False
+result.category      # none, toxicity, threat, doxxing, advertising, spam
+result.severity      # none, low, medium, high
+
+# Convenience checks
+result.is_toxic
+result.is_threat
+result.is_doxxing
+result.is_advertising
+result.is_spam
+```
+
+## Batch Moderation
+
+Send 5+ messages for a 50% discount on token cost.
+
+```python
+results = await client.moderate_batch([
+    "hello everyone",
+    "you're terrible at this game",
+    "check out my store at scam.com",
+])
+
+for r in results:
+    print(f"safe={r.safe} category={r.category}")
+```
+
+## Generic Model Execution
+
+Call any model by name, even ones added after your SDK version:
+
+```python
+response = await client.execute("moderation", "your input")
+
+response.kodari_model  # "moderation"
+response.tokens_cost   # 10
+response.result        # raw dict
+```
+
+## Session Flow (Code Generation)
+
+```python
+session = await client.create_session("My Plugin", "minecraft", "plugin", "claude-sonnet-4-5")
+gen = await client.generate(session.id, "Make a plugin that does X")
+compiled = await client.compile(session.id)
+jar_bytes = await client.download_jar(compiled.jar_id)
+
+with open("plugin.jar", "wb") as f:
+    f.write(jar_bytes)
+```
+
+## Other Endpoints
+
+```python
+# Get current user
+user = await client.get_me()
+print(user.name, user.email)
+```
+
+## Error Handling
+
+All exceptions extend `KodariException`:
+
+```python
+from kodari import (
+    KodariAuthenticationException,
+    KodariRateLimitException,
+    KodariInsufficientTokensException,
+)
+
+try:
+    result = await client.moderate("message")
+except KodariAuthenticationException:
+    print("Invalid API key")
+except KodariRateLimitException:
+    print("Rate limited, slow down")
+except KodariInsufficientTokensException:
+    print("Not enough tokens")
+```
+
+## Custom Configuration
+
+```python
+client = KodariClient(
+    KodariCredentials("kod-your-api-key"),
+    base_url="http://localhost:8080",
+    user_agent="my-app/2.0",
+)
+```
+
+## Requirements
+
+Python 3.10+

kodari-1.0.0/README.md

@@ -0,0 +1,129 @@
+# kodaripython
+
+Official Python SDK for the [Kodari API](https://kodari.ai). Fully async, built on httpx.
+
+## Installation
+
+```bash
+pip install kodari
+```
+
+## Quick Start
+
+Get your API key at [kodari.ai/api-keys](https://kodari.ai/api-keys).
+
+```python
+import asyncio
+from kodari import KodariClient, KodariCredentials
+
+async def main():
+    async with KodariClient(KodariCredentials("kod-your-api-key")) as client:
+        result = await client.moderate("hello everyone")
+
+        if not result.safe:
+            print(f"Flagged: {result.category}")  # toxicity, threat, doxxing, advertising, spam
+            print(f"Severity: {result.severity}")  # low, medium, high
+
+asyncio.run(main())
+```
+
+## Moderation
+
+Multilingual chat moderation AI that classifies messages for toxicity, threats, doxxing, spam, and advertising.
+
+```python
+result = await client.moderate("some message")
+
+result.safe          # True/False
+result.category      # none, toxicity, threat, doxxing, advertising, spam
+result.severity      # none, low, medium, high
+
+# Convenience checks
+result.is_toxic
+result.is_threat
+result.is_doxxing
+result.is_advertising
+result.is_spam
+```
+
+## Batch Moderation
+
+Send 5+ messages for a 50% discount on token cost.
+
+```python
+results = await client.moderate_batch([
+    "hello everyone",
+    "you're terrible at this game",
+    "check out my store at scam.com",
+])
+
+for r in results:
+    print(f"safe={r.safe} category={r.category}")
+```
+
+## Generic Model Execution
+
+Call any model by name, even ones added after your SDK version:
+
+```python
+response = await client.execute("moderation", "your input")
+
+response.kodari_model  # "moderation"
+response.tokens_cost   # 10
+response.result        # raw dict
+```
+
+## Session Flow (Code Generation)
+
+```python
+session = await client.create_session("My Plugin", "minecraft", "plugin", "claude-sonnet-4-5")
+gen = await client.generate(session.id, "Make a plugin that does X")
+compiled = await client.compile(session.id)
+jar_bytes = await client.download_jar(compiled.jar_id)
+
+with open("plugin.jar", "wb") as f:
+    f.write(jar_bytes)
+```
+
+## Other Endpoints
+
+```python
+# Get current user
+user = await client.get_me()
+print(user.name, user.email)
+```
+
+## Error Handling
+
+All exceptions extend `KodariException`:
+
+```python
+from kodari import (
+    KodariAuthenticationException,
+    KodariRateLimitException,
+    KodariInsufficientTokensException,
+)
+
+try:
+    result = await client.moderate("message")
+except KodariAuthenticationException:
+    print("Invalid API key")
+except KodariRateLimitException:
+    print("Rate limited, slow down")
+except KodariInsufficientTokensException:
+    print("Not enough tokens")
+```
+
+## Custom Configuration
+
+```python
+client = KodariClient(
+    KodariCredentials("kod-your-api-key"),
+    base_url="http://localhost:8080",
+    user_agent="my-app/2.0",
+)
+```
+
+## Requirements
+
+Python 3.10+

kodari-1.0.0/kodari/__init__.py

@@ -0,0 +1,17 @@
+from kodari.client import KodariClient
+from kodari.credentials import KodariCredentials
+from kodari.exceptions import (
+    KodariException,
+    KodariAuthenticationException,
+    KodariRateLimitException,
+    KodariInsufficientTokensException,
+)
+
+__all__ = [
+    "KodariClient",
+    "KodariCredentials",
+    "KodariException",
+    "KodariAuthenticationException",
+    "KodariRateLimitException",
+    "KodariInsufficientTokensException",
+]

kodari-1.0.0/kodari/client.py

@@ -0,0 +1,194 @@
+from typing import List, Optional
+
+import httpx
+
+from kodari.credentials import KodariCredentials
+from kodari.exceptions import (
+    KodariAuthenticationException,
+    KodariException,
+    KodariInsufficientTokensException,
+    KodariRateLimitException,
+)
+from kodari.models.responses import (
+    CompileResponse,
+    GenerateResponse,
+    ModelResponse,
+    ModerationResult,
+    SessionResponse,
+    UserResponse,
+)
+
+_DEFAULT_BASE_URL = "https://api.kodari.ai"
+_API_PREFIX = "/api/v1"
+_DEFAULT_USER_AGENT = "kodari-python/1.0.0"
+_MODERATION = "moderation"
+
+
+class KodariClient:
+
+    def __init__(
+        self,
+        credentials: KodariCredentials,
+        base_url: str = _DEFAULT_BASE_URL,
+        user_agent: str = _DEFAULT_USER_AGENT,
+    ):
+        self._credentials = credentials
+        self._base_url = base_url
+        self._client = httpx.AsyncClient(
+            headers={
+                "X-API-Key": credentials.api_key,
+                "User-Agent": user_agent,
+            },
+            timeout=60.0, # cf
+        )
+
+    async def close(self):
+        await self._client.aclose()
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, *args):
+        await self.close()
+
+    # Normal endpoints
+
+    async def get_me(self) -> UserResponse:
+        data = await self._get("/users/me")
+        return UserResponse(
+            id=data["id"],
+            provider_id=data.get("providerId", ""),
+            email=data.get("email", ""),
+            name=data.get("name", ""),
+            image_url=data.get("imageUrl", ""),
+            role=data.get("role", ""),
+            discord_id=data.get("discordId", ""),
+            bio=data.get("bio", ""),
+            created_at=data.get("createdAt", ""),
+            banned=data.get("banned", False),
+            banned_reason=data.get("bannedReason", ""),
+            settings=data.get("settings", {}),
+            new_account=data.get("newAccount", False),
+        )
+
+    async def create_session(
+        self,
+        name: str,
+        game_type: str,
+        category: str,
+        ai_model: str,
+    ) -> SessionResponse:
+        data = await self._post("/sessions", {
+            "name": name,
+            "gameType": game_type,
+            "category": category,
+            "aiModel": ai_model,
+        })
+        return SessionResponse(
+            id=data["id"],
+            name=data["name"],
+            game_type=data.get("gameType", ""),
+            category=data.get("category", ""),
+            status=data.get("status", ""),
+        )
+
+    async def generate(
+        self,
+        session_id: str,
+        message: str,
+        has_dependencies: bool = False,
+    ) -> GenerateResponse:
+        data = await self._post(f"/sessions/{session_id}/generate", {
+            "message": message,
+            "hasDependencies": has_dependencies,
+        })
+        return GenerateResponse(
+            session_id=data["sessionId"],
+            success=data["success"],
+            message=data["message"],
+        )
+
+    async def compile(self, session_id: str) -> CompileResponse:
+        data = await self._post(f"/sessions/{session_id}/compile", {})
+        return CompileResponse(
+            session_id=data["sessionId"],
+            success=data["success"],
+            jar_id=data.get("jarId"),
+            plugin_name=data.get("pluginName"),
+            jar_size=data.get("jarSize"),
+            error=data.get("error"),
+        )
+
+    async def download_jar(self, jar_id: int) -> bytes:
+        url = f"{self._base_url}{_API_PREFIX}/download/jar/{jar_id}"
+        response = await self._client.post(
+            url,
+            json={},
+            headers={"Content-Type": "application/json"},
+        )
+        self._check_status(response.status_code, response.text)
+        return response.content
+
+    # Kodari Specialized Models
+
+    async def moderate(self, message: str) -> ModerationResult:
+        response = await self.execute(_MODERATION, message)
+        result = response.result
+        return ModerationResult(
+            safe=result["safe"],
+            category=result["category"],
+            severity=result["severity"],
+        )
+
+    async def moderate_batch(self, messages: List[str]) -> List[ModerationResult]:
+        response = await self.execute_batch(_MODERATION, messages)
+        return [
+            ModerationResult(
+                safe=r["safe"],
+                category=r["category"],
+                severity=r["severity"],
+                index=r.get("index", -1),
+            )
+            for r in response.result
+        ]
+
+    async def execute(self, model: str, input: str) -> ModelResponse:
+        data = await self._post(f"/models/{model}", {"input": input})
+        return ModelResponse(
+            kodari_model=data["kodariModel"],
+            tokens_cost=data["tokensCost"],
+            result=data["result"],
+        )
+
+    async def execute_batch(self, model: str, inputs: List[str]) -> ModelResponse:
+        data = await self._post(f"/models/{model}/batch", {"inputs": inputs})
+        return ModelResponse(
+            kodari_model=data["kodariModel"],
+            tokens_cost=data["tokensCost"],
+            result=data["result"],
+        )
+
+    # Generic API access
+
+    async def _get(self, path: str) -> dict:
+        url = f"{self._base_url}{_API_PREFIX}{path}"
+        response = await self._client.get(url)
+        self._check_status(response.status_code, response.text)
+        return response.json()
+
+    async def _post(self, path: str, body: dict) -> dict:
+        url = f"{self._base_url}{_API_PREFIX}{path}"
+        response = await self._client.post(url, json=body)
+        self._check_status(response.status_code, response.text)
+        return response.json()
+
+    @staticmethod
+    def _check_status(status: int, body: str):
+        if status == 401:
+            raise KodariAuthenticationException("Invalid or expired API key")
+        if status == 429:
+            raise KodariRateLimitException("Rate limit exceeded")
+        if status == 402:
+            raise KodariInsufficientTokensException("Insufficient tokens")
+        if status != 200:
+            raise KodariException(f"API error (HTTP {status}): {body}")

kodari-1.0.0/kodari/credentials.py

@@ -0,0 +1,14 @@
+class KodariCredentials:
+
+    def __init__(self, api_key: str):
+        if not api_key:
+            raise ValueError("api_key must not be None or empty")
+
+        if not api_key.startswith("kod-"):
+            raise ValueError("Invalid API key format. Keys must start with 'kod-'")
+
+        self._api_key = api_key
+
+    @property
+    def api_key(self) -> str:
+        return self._api_key

kodari-1.0.0/kodari/exceptions.py

@@ -0,0 +1,14 @@
+class KodariException(Exception):
+    pass
+
+
+class KodariAuthenticationException(KodariException):
+    pass
+
+
+class KodariRateLimitException(KodariException):
+    pass
+
+
+class KodariInsufficientTokensException(KodariException):
+    pass

kodari-1.0.0/kodari/models/__init__.py

@@ -0,0 +1,17 @@
+from kodari.models.responses import (
+    UserResponse,
+    SessionResponse,
+    GenerateResponse,
+    CompileResponse,
+    ModelResponse,
+    ModerationResult,
+)
+
+__all__ = [
+    "UserResponse",
+    "SessionResponse",
+    "GenerateResponse",
+    "CompileResponse",
+    "ModelResponse",
+    "ModerationResult",
+]

kodari-1.0.0/kodari/models/responses.py

@@ -0,0 +1,80 @@
+from dataclasses import dataclass
+from typing import Any, Optional
+
+
+@dataclass
+class UserResponse:
+    id: str
+    provider_id: str
+    email: str
+    name: str
+    image_url: str
+    role: str
+    discord_id: str
+    bio: str
+    created_at: str
+    banned: bool
+    banned_reason: str
+    settings: dict
+    new_account: bool
+
+
+@dataclass
+class SessionResponse:
+    id: str
+    name: str
+    game_type: str
+    category: str
+    status: str
+
+
+@dataclass
+class GenerateResponse:
+    session_id: str
+    success: bool
+    message: str
+
+
+@dataclass
+class CompileResponse:
+    session_id: str
+    success: bool
+    jar_id: Optional[int] = None
+    plugin_name: Optional[str] = None
+    jar_size: Optional[int] = None
+    error: Optional[str] = None
+
+
+@dataclass
+class ModelResponse:
+    kodari_model: str
+    tokens_cost: int
+    result: Any
+
+
+@dataclass
+class ModerationResult:
+    safe: bool
+    category: str
+    severity: str
+    index: int = -1
+
+    @property
+    def is_toxic(self) -> bool:
+        return self.category == "toxicity"
+
+    @property
+    def is_threat(self) -> bool:
+        return self.category == "threat"
+
+    @property
+    def is_doxxing(self) -> bool:
+        return self.category == "doxxing"
+
+    @property
+    def is_advertising(self) -> bool:
+        return self.category == "advertising"
+
+    @property
+    def is_spam(self) -> bool:
+        return self.category == "spam"

kodari-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "kodari"
+version = "1.0.0"
+description = "Official Python SDK for the Kodari API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Kodari", email = "support@kodari.ai" }
+]
+keywords = ["kodari", "ai", "moderation", "api"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "httpx>=0.28.0",
+]
+
+[project.urls]
+Homepage = "https://kodari.ai"
+Repository = "https://github.com/kodari-ai/kodaripython"