vision-agents-plugins-minimax 0.6.3__tar.gz

vision_agents_plugins_minimax-0.6.3/.gitignore

@@ -0,0 +1,102 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.cursor/*
+# Distribution / packaging
+.Python
+build/
+dist/
+downloads/
+develop-eggs/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+pip-wheel-metadata/
+MANIFEST
+*.egg-info/
+*.egg
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+coverage.xml
+nosetests.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Type checker / lint caches
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pytype/
+.pyre/
+.ruff_cache/
+
+# Environments
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.env
+.env.local
+.env.*.local
+.env.bak
+pyvenv.cfg
+.python-version
+
+# Editors / IDEs
+.vscode/
+.idea/
+
+# Jupyter Notebook
+.ipynb_checkpoints/
+
+# OS / Misc
+.DS_Store
+*.log
+
+# Tooling & repo-specific
+pyrightconfig.json
+shell.nix
+bin/*
+lib/*
+stream-py/
+
+# Example lock files (regenerated by uv sync)
+examples/*/uv.lock
+plugins/*/example/uv.lock
+
+# Artifacts / assets
+*.pt
+*.kef
+*.onnx
+profile.html
+
+/opencode.json
+.ralph-tui/
+.claude/*
+!.claude/skills/
+
+.uv-cache/
+
+# pytest json report
+.report.json

vision_agents_plugins_minimax-0.6.3/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: vision-agents-plugins-minimax
+Version: 0.6.3
+Summary: MiniMax plugin for vision agents
+Project-URL: Documentation, https://visionagents.ai/
+Project-URL: Website, https://visionagents.ai/
+Project-URL: Source, https://github.com/GetStream/Vision-Agents
+License-Expression: MIT
+Keywords: AI,agents,chat,llm,minimax,real-time,voice agents
+Requires-Python: >=3.10
+Requires-Dist: openai<3,>=2.26.0
+Requires-Dist: vision-agents
+Requires-Dist: vision-agents-plugins-openai
+Description-Content-Type: text/markdown
+
+# MiniMax Plugin for Vision Agents
+
+The MiniMax plugin adds the [MiniMax](https://platform.minimax.io) family of language models as a first-class LLM provider for [Vision Agents](https://visionagents.ai). It uses the OpenAI-compatible Chat Completions API at `https://api.minimax.io/v1`, so the implementation inherits the streaming and tool-calling behavior of the OpenAI Chat Completions plugin.
+
+## Installation
+
+```bash
+uv add "vision-agents-plugins-minimax"
+```
+
+## Configuration
+
+Set your MiniMax API key (sign up at <https://platform.minimax.io>):
+
+```bash
+export MINIMAX_API_KEY=...
+```
+
+The plugin also honors `MINIMAX_BASE_URL` for users that proxy the API.
+
+## Models
+
+| Model | Description |
+|-------|-------------|
+| `MiniMax-M3` (default) | Latest flagship model. 512K context window, up to 128K output, supports image input. |
+| `MiniMax-M2.7` | Previous generation flagship model. |
+| `MiniMax-M2.7-highspeed` | Low-latency variant of M2.7. |
+
+## Usage
+
+```python
+from vision_agents.plugins import minimax
+
+llm = minimax.LLM()  # defaults to MiniMax-M3
+llm = minimax.LLM(model="MiniMax-M2.7")
+```
+
+## Notes
+
+- Default base URL is `https://api.minimax.io/v1` (overseas). Do not use `api.minimax.chat` for production traffic.
+- Default `temperature` is `1.0` (the API rejects `0.0`).
+- The `response_format` field is not supported by the MiniMax Chat Completions API and is intentionally not exposed.

vision_agents_plugins_minimax-0.6.3/README.md

@@ -0,0 +1,42 @@
+# MiniMax Plugin for Vision Agents
+
+The MiniMax plugin adds the [MiniMax](https://platform.minimax.io) family of language models as a first-class LLM provider for [Vision Agents](https://visionagents.ai). It uses the OpenAI-compatible Chat Completions API at `https://api.minimax.io/v1`, so the implementation inherits the streaming and tool-calling behavior of the OpenAI Chat Completions plugin.
+
+## Installation
+
+```bash
+uv add "vision-agents-plugins-minimax"
+```
+
+## Configuration
+
+Set your MiniMax API key (sign up at <https://platform.minimax.io>):
+
+```bash
+export MINIMAX_API_KEY=...
+```
+
+The plugin also honors `MINIMAX_BASE_URL` for users that proxy the API.
+
+## Models
+
+| Model | Description |
+|-------|-------------|
+| `MiniMax-M3` (default) | Latest flagship model. 512K context window, up to 128K output, supports image input. |
+| `MiniMax-M2.7` | Previous generation flagship model. |
+| `MiniMax-M2.7-highspeed` | Low-latency variant of M2.7. |
+
+## Usage
+
+```python
+from vision_agents.plugins import minimax
+
+llm = minimax.LLM()  # defaults to MiniMax-M3
+llm = minimax.LLM(model="MiniMax-M2.7")
+```
+
+## Notes
+
+- Default base URL is `https://api.minimax.io/v1` (overseas). Do not use `api.minimax.chat` for production traffic.
+- Default `temperature` is `1.0` (the API rejects `0.0`).
+- The `response_format` field is not supported by the MiniMax Chat Completions API and is intentionally not exposed.

vision_agents_plugins_minimax-0.6.3/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vision-agents-plugins-minimax"
+dynamic = ["version"]
+description = "MiniMax plugin for vision agents"
+readme = "README.md"
+keywords = ["minimax", "llm", "real-time", "chat", "AI", "voice agents", "agents"]
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = [
+    "vision-agents",
+    "vision-agents-plugins-openai",
+    "openai>=2.26.0,<3",
+]
+
+[project.urls]
+Documentation = "https://visionagents.ai/"
+Website = "https://visionagents.ai/"
+Source = "https://github.com/GetStream/Vision-Agents"
+
+[tool.hatch.version]
+source = "vcs"
+raw-options = { root = "..", search_parent_directories = true, fallback_version = "0.0.0" }
+
+[tool.hatch.build.targets.wheel]
+packages = ["vision_agents"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/vision_agents"]
+
+[tool.uv.sources]
+vision-agents = { workspace = true }
+vision-agents-plugins-openai = { workspace = true }
+
+[dependency-groups]
+dev = [
+    "pytest>=8.4.1",
+    "pytest-asyncio>=1.0.0",
+]

vision_agents_plugins_minimax-0.6.3/vision_agents/plugins/minimax/__init__.py

@@ -0,0 +1,3 @@
+from .minimax_llm import MiniMaxLLM as LLM
+
+__all__ = ["LLM"]

vision_agents_plugins_minimax-0.6.3/vision_agents/plugins/minimax/minimax_llm.py

@@ -0,0 +1,83 @@
+"""MiniMax LLM implementation using OpenAI-compatible Chat Completions API.
+
+MiniMax provides an OpenAI-compatible API at https://api.minimax.io/v1.
+Supported models: MiniMax-M3 (default), MiniMax-M2.7, MiniMax-M2.7-highspeed.
+"""
+
+import logging
+import os
+from typing import Any
+
+from openai import AsyncOpenAI
+from vision_agents.plugins.openai import ChatCompletionsLLM
+
+logger = logging.getLogger(__name__)
+
+
+PLUGIN_NAME = "minimax"
+
+DEFAULT_BASE_URL = "https://api.minimax.io/v1"
+DEFAULT_MODEL = "MiniMax-M3"
+
+
+class MiniMaxLLM(ChatCompletionsLLM):
+    """MiniMax LLM using OpenAI-compatible Chat Completions API.
+
+    MiniMax provides high-performance language models accessible through
+    an OpenAI-compatible API. This plugin reuses the OpenAI Chat Completions
+    streaming and tool-calling implementation, including ``<think>`` reasoning
+    stripping for reasoning models such as MiniMax-M3.
+
+    Examples:
+
+        from vision_agents.plugins import minimax
+        llm = minimax.LLM()
+    """
+
+    provider_name = PLUGIN_NAME
+
+    def __init__(
+        self,
+        *,
+        model: str = DEFAULT_MODEL,
+        api_key: str | None = None,
+        base_url: str | None = None,
+        client: AsyncOpenAI | None = None,
+        max_tokens: int | None = None,
+        tools_max_rounds: int = 3,
+    ) -> None:
+        """Initialize the MiniMaxLLM class.
+
+        Args:
+            model: The MiniMax model to use.
+                Defaults to ``"MiniMax-M3"`` (latest flagship, 512K context).
+                Supported models: ``"MiniMax-M3"``, ``"MiniMax-M2.7"``,
+                ``"MiniMax-M2.7-highspeed"``.
+            api_key: Optional API key. Defaults to ``MINIMAX_API_KEY`` env var.
+            base_url: Optional base URL. Defaults to
+                ``https://api.minimax.io/v1`` (overseas endpoint).
+            client: Optional ``AsyncOpenAI`` client for dependency injection.
+            max_tokens: This sets the upper limit for the number of tokens the
+                model can generate in response.
+            tools_max_rounds: max calling rounds for multi-hop tool call.
+        """
+        if client is None:
+            if api_key is None:
+                api_key = os.environ.get("MINIMAX_API_KEY")
+            if base_url is None:
+                base_url = os.environ.get("MINIMAX_BASE_URL", DEFAULT_BASE_URL)
+        super().__init__(
+            model=model,
+            api_key=api_key,
+            base_url=base_url,
+            client=client,
+            tools_max_rounds=tools_max_rounds,
+        )
+        self._max_tokens = max_tokens
+
+    def _extra_request_kwargs(self) -> dict[str, Any]:
+        # MiniMax rejects temperature 0.0, so default to 1.0.
+        kwargs: dict[str, Any] = {"temperature": 1.0}
+        if self._max_tokens is not None:
+            kwargs["max_tokens"] = self._max_tokens
+        return kwargs