fishr 0.0.1__tar.gz

fishr-0.0.1/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: fishr
+Version: 0.0.1
+Summary: A python library for free LLMs & usable in your python projects. (Grok, Sonnet, GPT)
+Author: fuhnut
+License: MIT
+Project-URL: Homepage, https://github.com/breedservices/fishr
+Project-URL: Repository, https://github.com/breedservices/fishr
+Project-URL: Issues, https://github.com/breedservices/fishr/issues
+Keywords: llm,ai,grok,gpt,gemini,sonnet,chat,completions,free,no-auth,gpt4free
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: uvloop>=0.22.1; sys_platform != "win32"
+Requires-Dist: primp
+Requires-Dist: msgspec
+Requires-Dist: static-ffmpeg
+
+# fishr
+
+FREE LLM ACCESS FROM PYTHON. NO KEYS! NO AUTH! NO LIMITS!
+
+## Install
+
+```bash
+pip install fishr
+```
+
+## Quick Start
+
+```python
+from fishr import Client
+
+client = Client()
+
+# Chat completion
+response = client.chat.completions.create(
+    model="noxus/openai",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+print(response.text)
+
+# Streaming
+response = client.chat.completions.create(
+    model="noxus/openai",
+    messages=[{"role": "user", "content": "Tell me a story"}],
+    stream=True,
+)
+for chunk in response:
+    print(chunk.choices[0].delta.content or "", end="")
+
+# Web search
+response = client.chat.completions.create(
+    model="noxus/grok-4.3",
+    messages=[{"role": "user", "content": "Latest news on SpaceX"}],
+    web_search=True,
+)
+print(response.text)
+
+# Image generation
+result = client.images.generate(
+    model="deepai/image",
+    prompt="A cat riding a skateboard",
+)
+print(result.data[0].url)
+
+# Agent
+result = client.agents.run(
+    model="noxus/openai",
+    prompt="Research quantum computing",
+    tools=[{"type": "web_search"}],
+)
+print(result.content)
+
+# Multi-turn conversation
+conv = client.conversation(model="noxus/openai")
+conv.system("You are a helpful assistant.")
+conv.ask("Remember: 42")
+conv.ask("What number did I say?")
+```
+
+## Async
+
+```python
+from fishr import AsyncClient
+
+client = AsyncClient()
+
+response = await client.chat.completions.create(
+    model="deepai/standard",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+print(response.text)
+
+# Async streaming
+response = await client.chat.completions.create(
+    model="opera/aria",
+    messages=[{"role": "user", "content": "Tell me a story"}],
+    stream=True,
+)
+async for chunk in response:
+    print(chunk.choices[0].delta.content or "", end="")
+
+# Async conversation
+conv = client.conversation(model="noxus/openai")
+await conv.ask("Remember: 42")
+await conv.ask("What number did I say?")
+```
+
+## Direct Provider Access
+
+```python
+from fishr import OperaAria, Yqcloud
+
+# Use a provider directly
+opera = OperaAria()
+result = opera.ask("Hello!", model="opera/aria")
+print(result.content)
+
+yqcloud = Yqcloud()
+result = yqcloud.chat([{"role": "user", "content": "Hi!"}])
+print(result.content)
+```
+
+## Models
+
+Models are specified as `provider/name`:
+
+| Provider | Models | Features |
+|----------|--------|----------|
+| **Noxus** | `noxus/openai`, `noxus/google`, `noxus/sonnet-4.6`, `noxus/sonnet-3.5`, `noxus/grok-4.3`, `noxus/perplexity`, `noxus/metaai`, `noxus/qwen` | Web search, images, history, system messages |
+| **DeepAI** | `deepai/standard`, `deepai/online`, `deepai/gemma-4`, `deepai/gemini-2.5-flash-lite`, `deepai/deepseek-v3.2`, `deepai/image` | Web search (online), images, history, system messages |
+| **Quillbot** | `quillbot/quillbot`, `quillbot/quillbot-search` | Web search (quillbot-search), history, system messages |
+| **NoTrack** | `notrack/fast`, `notrack/standard`, `notrack/reasoning` | History |
+| **DphnAI** | `dphnai/24b`, `dphnai/6b` | History, system messages |
+| **Yqcloud** | `yqcloud/gpt-4` | History, system messages |
+| **Opera Aria** | `opera/aria` | Images, history, system messages |
+
+The provider prefix is optional for Noxus (default).
+
+## Requirements
+
+- Python >= 3.11

fishr-0.0.1/README.md

@@ -0,0 +1,125 @@
+# fishr
+
+FREE LLM ACCESS FROM PYTHON. NO KEYS! NO AUTH! NO LIMITS!
+
+## Install
+
+```bash
+pip install fishr
+```
+
+## Quick Start
+
+```python
+from fishr import Client
+
+client = Client()
+
+# Chat completion
+response = client.chat.completions.create(
+    model="noxus/openai",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+print(response.text)
+
+# Streaming
+response = client.chat.completions.create(
+    model="noxus/openai",
+    messages=[{"role": "user", "content": "Tell me a story"}],
+    stream=True,
+)
+for chunk in response:
+    print(chunk.choices[0].delta.content or "", end="")
+
+# Web search
+response = client.chat.completions.create(
+    model="noxus/grok-4.3",
+    messages=[{"role": "user", "content": "Latest news on SpaceX"}],
+    web_search=True,
+)
+print(response.text)
+
+# Image generation
+result = client.images.generate(
+    model="deepai/image",
+    prompt="A cat riding a skateboard",
+)
+print(result.data[0].url)
+
+# Agent
+result = client.agents.run(
+    model="noxus/openai",
+    prompt="Research quantum computing",
+    tools=[{"type": "web_search"}],
+)
+print(result.content)
+
+# Multi-turn conversation
+conv = client.conversation(model="noxus/openai")
+conv.system("You are a helpful assistant.")
+conv.ask("Remember: 42")
+conv.ask("What number did I say?")
+```
+
+## Async
+
+```python
+from fishr import AsyncClient
+
+client = AsyncClient()
+
+response = await client.chat.completions.create(
+    model="deepai/standard",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+print(response.text)
+
+# Async streaming
+response = await client.chat.completions.create(
+    model="opera/aria",
+    messages=[{"role": "user", "content": "Tell me a story"}],
+    stream=True,
+)
+async for chunk in response:
+    print(chunk.choices[0].delta.content or "", end="")
+
+# Async conversation
+conv = client.conversation(model="noxus/openai")
+await conv.ask("Remember: 42")
+await conv.ask("What number did I say?")
+```
+
+## Direct Provider Access
+
+```python
+from fishr import OperaAria, Yqcloud
+
+# Use a provider directly
+opera = OperaAria()
+result = opera.ask("Hello!", model="opera/aria")
+print(result.content)
+
+yqcloud = Yqcloud()
+result = yqcloud.chat([{"role": "user", "content": "Hi!"}])
+print(result.content)
+```
+
+## Models
+
+Models are specified as `provider/name`:
+
+| Provider | Models | Features |
+|----------|--------|----------|
+| **Noxus** | `noxus/openai`, `noxus/google`, `noxus/sonnet-4.6`, `noxus/sonnet-3.5`, `noxus/grok-4.3`, `noxus/perplexity`, `noxus/metaai`, `noxus/qwen` | Web search, images, history, system messages |
+| **DeepAI** | `deepai/standard`, `deepai/online`, `deepai/gemma-4`, `deepai/gemini-2.5-flash-lite`, `deepai/deepseek-v3.2`, `deepai/image` | Web search (online), images, history, system messages |
+| **Quillbot** | `quillbot/quillbot`, `quillbot/quillbot-search` | Web search (quillbot-search), history, system messages |
+| **NoTrack** | `notrack/fast`, `notrack/standard`, `notrack/reasoning` | History |
+| **DphnAI** | `dphnai/24b`, `dphnai/6b` | History, system messages |
+| **Yqcloud** | `yqcloud/gpt-4` | History, system messages |
+| **Opera Aria** | `opera/aria` | Images, history, system messages |
+
+The provider prefix is optional for Noxus (default).
+
+## Requirements
+
+- Python >= 3.11

fishr-0.0.1/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "fishr"
+version = "0.0.1"
+description = "A python library for free LLMs & usable in your python projects. (Grok, Sonnet, GPT)"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+    { name = "fuhnut" }
+]
+keywords = [
+    "llm",
+    "ai",
+    "grok",
+    "gpt",
+    "gemini",
+    "sonnet",
+    "chat",
+    "completions",
+    "free",
+    "no-auth",
+    "gpt4free",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "uvloop>=0.22.1 ; sys_platform != 'win32'",
+    "primp",
+    "msgspec",
+    "static-ffmpeg",
+]
+
+[project.urls]
+Homepage = "https://github.com/breedservices/fishr"
+Repository = "https://github.com/breedservices/fishr"
+Issues = "https://github.com/breedservices/fishr/issues"
+
+[project.scripts]
+fishr = "fishr.__main__:main"
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

fishr-0.0.1/setup.cfg

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