revengelibrary 0.1.0__py3-none-any.whl

revengelibrary/__init__.py

@@ -0,0 +1,4 @@
+from .chat import FreeNeuroChatClient, APIError
+
+__all__ = ["FreeNeuroChatClient", "APIError"]
+__version__ = "0.1.0"

revengelibrary/chat.py

@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any
+
+import requests
+
+
+class APIError(RuntimeError):
+    """Raised when the upstream API returns an invalid response."""
+
+
+@dataclass
+class FreeNeuroChatClient:
+    """Small wrapper around OpenRouter's OpenAI-compatible chat endpoint."""
+
+    api_key: str
+    model: str = "meta-llama/llama-3.1-8b-instruct:free"
+    base_url: str = "https://openrouter.ai/api/v1"
+    timeout: int = 60
+    system_prompt: str | None = "You are a helpful assistant."
+    messages: list[dict[str, str]] = field(default_factory=list)
+
+    def __post_init__(self) -> None:
+        if not self.api_key:
+            raise ValueError("api_key is required")
+        if self.system_prompt and not self.messages:
+            self.messages.append({"role": "system", "content": self.system_prompt})
+
+    def send(self, user_message: str) -> str:
+        """Send user text and return assistant reply."""
+        user_message = user_message.strip()
+        if not user_message:
+            raise ValueError("user_message must not be empty")
+
+        self.messages.append({"role": "user", "content": user_message})
+        payload = {"model": self.model, "messages": self.messages}
+
+        response = requests.post(
+            f"{self.base_url}/chat/completions",
+            headers=self._headers(),
+            json=payload,
+            timeout=self.timeout,
+        )
+
+        if response.status_code >= 400:
+            raise APIError(
+                f"API returned {response.status_code}: {response.text[:500]}"
+            )
+
+        data = response.json()
+        content = self._extract_content(data)
+        self.messages.append({"role": "assistant", "content": content})
+        return content
+
+    def reset(self) -> None:
+        """Clear dialog history but keep initial system prompt."""
+        self.messages = []
+        if self.system_prompt:
+            self.messages.append({"role": "system", "content": self.system_prompt})
+
+    def _headers(self) -> dict[str, str]:
+        return {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json",
+        }
+
+    @staticmethod
+    def _extract_content(data: dict[str, Any]) -> str:
+        try:
+            content = data["choices"][0]["message"]["content"]
+            if not isinstance(content, str) or not content.strip():
+                raise KeyError
+            return content
+        except (KeyError, TypeError, IndexError):
+            raise APIError(f"Unexpected API response: {data}") from None

revengelibrary/cli.py

@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+import argparse
+import os
+
+from .chat import APIError, FreeNeuroChatClient
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="revengelibrary",
+        description="Interactive terminal chat with free OpenRouter models.",
+    )
+    parser.add_argument(
+        "--api-key",
+        default=os.getenv("OPENROUTER_API_KEY", ""),
+        help="OpenRouter API key. Fallback: OPENROUTER_API_KEY env var.",
+    )
+    parser.add_argument(
+        "--model",
+        default="meta-llama/llama-3.1-8b-instruct:free",
+        help="Model name on OpenRouter (default uses a free model).",
+    )
+    parser.add_argument(
+        "--system",
+        default="You are a helpful assistant.",
+        help="System prompt.",
+    )
+    return parser
+
+
+def main() -> int:
+    parser = _build_parser()
+    args = parser.parse_args()
+
+    if not args.api_key:
+        parser.error("API key is required: pass --api-key or set OPENROUTER_API_KEY.")
+
+    client = FreeNeuroChatClient(
+        api_key=args.api_key,
+        model=args.model,
+        system_prompt=args.system,
+    )
+
+    print("Interactive chat started. Type 'exit' to quit, 'reset' to clear history.")
+    while True:
+        try:
+            text = input("you> ").strip()
+        except (EOFError, KeyboardInterrupt):
+            print("\nbye")
+            return 0
+
+        if not text:
+            continue
+        if text.lower() in {"exit", "quit"}:
+            print("bye")
+            return 0
+        if text.lower() == "reset":
+            client.reset()
+            print("history reset")
+            continue
+
+        try:
+            answer = client.send(text)
+            print(f"ai> {answer}")
+        except APIError as exc:
+            print(f"api error: {exc}")
+        except Exception as exc:  # noqa: BLE001
+            print(f"unexpected error: {exc}")
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

revengelibrary-0.1.0.dist-info/METADATA

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: revengelibrary
+Version: 0.1.0
+Summary: Python chat library and CLI for free LLM models via OpenRouter.
+Author: revengebibliotek contributors
+License: MIT
+Project-URL: Homepage, https://github.com/example/revengelibrary
+Keywords: chat,llm,openrouter,api,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Dynamic: license-file
+
+# revengelibrary
+
+Небольшая Python-библиотека и CLI для чата с нейросетью через бесплатные модели OpenRouter.
+
+## Установка
+
+Из PyPI (после публикации):
+
+```bash
+pip install revengelibrary
+```
+
+Локально из папки проекта:
+
+```bash
+pip install .
+```
+
+Для разработки:
+
+```bash
+pip install -e .
+```
+
+## Подготовка API ключа
+
+1. Создай бесплатный API key в OpenRouter.
+2. Экспортируй ключ:
+
+```bash
+export OPENROUTER_API_KEY="your_key"
+```
+
+## Использование в Python
+
+```python
+from revengelibrary import FreeNeuroChatClient
+
+client = FreeNeuroChatClient(api_key="your_key")
+reply = client.send("Привет! Расскажи коротко анекдот.")
+print(reply)
+```
+
+## Запуск из терминала
+
+После установки доступна команда:
+
+```bash
+revengelibrary --model meta-llama/llama-3.1-8b-instruct:free
+```
+
+Если ключ лежит в `OPENROUTER_API_KEY`, то `--api-key` можно не передавать.
+
+## Минимальный API библиотеки
+
+- `FreeNeuroChatClient.send(text: str) -> str`
+- `FreeNeuroChatClient.reset() -> None`
+
+## Публикация в PyPI
+
+```bash
+python3 -m pip install --upgrade build twine
+python3 -m build
+python3 -m twine upload dist/*
+```
+
+После этого любой человек сможет установить библиотеку:
+
+```bash
+pip install revengelibrary
+```

revengelibrary-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+revengelibrary/__init__.py,sha256=fTxpG-6tD8L7mRvBv19uO7mZUgI0VYdTe7NS0V7TFQY,117
+revengelibrary/chat.py,sha256=tjwxG01Tg7FSp850px-15jP6Tuygo5U3w_oSLBrzZgE,2582
+revengelibrary/cli.py,sha256=bXiwnGuJFChOT6cxBOkT8FGtFed0LIrCdc8yIND4oZk,1961
+revengelibrary-0.1.0.dist-info/licenses/LICENSE,sha256=UgqQ8UtVfIOP8-clGkGAylmb9AUbT4-Ue49N_WjIpi4,1073
+revengelibrary-0.1.0.dist-info/METADATA,sha256=pFHcFRcvos2tVXN0D7xGtgwz4-miIMryB1eBbkCVXSU,2137
+revengelibrary-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+revengelibrary-0.1.0.dist-info/entry_points.txt,sha256=299WMDffRchuwIlqEIjW-DwHYkBvRZQwGjiASIVofYE,59
+revengelibrary-0.1.0.dist-info/top_level.txt,sha256=gfUsAxA-IgliQakMoupLAAjrTEYtUJurH5n29eHhUBE,15
+revengelibrary-0.1.0.dist-info/RECORD,,

revengelibrary-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

revengelibrary-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+revengelibrary = revengelibrary.cli:main

revengelibrary-0.1.0.dist-info/licenses/LICENSE

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

revengelibrary-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+revengelibrary