This release is a pre-release and may not be stable for production use.
neobot-chat
Main-model native vision
Native image support is explicit and defaults off; merely selecting a model name never enables it. Example application configuration:
[models.primary_chat_model]
provider = "DeepSeek"
model_name = "deepseek-v4-flash-vision-exp"
native_vision = true
[agent_model]
main_agent = 0
The fallback route is always models.vision_model; no fallback model slot has
to be selected by hand. Existing configurations keep the text-only behavior
(ModelRegistration.native_vision = false).
RegisteredModel.native_vision is propagated to DeepSeek/OpenAI/Anthropic
providers. build_main_provider wraps the visual main provider in
NativeVisionFallbackProvider; its read-only native_vision and model
properties always describe the active route. A provider/configuration reload
creates a fresh instance and re-enables the configured visual route.
Images and fallback
The shared message format uses user-role content arrays with text and
{"type": "image_url", "image_url": {"url": "https://... or data:image/...;base64,..."}}.
DeepSeek requires user-role images. OpenAI-compatible providers retain image
blocks, and Anthropic converts URL/base64 blocks to its native image.source
format, including images nested inside tool results. The chat layer does not
upload images through a Files API.
A visual request is retried on the configured text provider only for an
explicit HTTP 400/422 image-capability rejection (including content-array
incompatibility) or a typed local NativeVisionUnsupportedError. Invalid image
URLs/data, size limits, generic validation failures, authentication errors,
rate limits, transport failures, and server errors do not cause degradation.
Streaming can retry only before any output has been emitted.
Degradation is persistent for the provider instance. Two modes:
- vision-capable fallback (default when the fallback declares
native_vision=True, i.e.models.vision_model): messages and tools pass through unchanged, so the fallback still sees the images; logs at warning level andprovider.native_visionstaysTrue; - text-only fallback (
strip_images=True): every fallback request replaces image blocks with visible text placeholders, adds a system notice stating the model did not see the images, removesimage_context__*tools, and logs at error level.
Input messages are never mutated. The agent receives structured metadata:
provider.native_vision # active route capability (True with a vision fallback)
provider.vision_degradation # reason/from_model/to_model/notice, or None
response["extensions"]["native_vision_fallback"] # same metadata on fallback responses
Agents should refresh their dynamically available tools after this signal and use a separate image-parsing tool when visual evidence is still needed; they must not claim the text-only model viewed omitted images. Configuration-time failure to create the visual provider also selects the configured fallback with an explicit error and the same metadata. An invalid or unavailable fallback route is a startup configuration error, not an implicit model selection.
DeepSeek protocol reference: https://api-docs.deepseek.com/zh-cn/guides/vision.
1 maintainer
Metadata
1 maintainer
Release files for neobot-chat 2.0.0a2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| neobot_chat-2.0.0a2.tar.gz | 52.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| neobot_chat-2.0.0a2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 121.6 kB
Release files / neobot_chat-2.0.0a2.tar.gz
| Download URL | neobot_chat-2.0.0a2.tar.gz |
|---|---|
| Size | 52.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f78aecaa1aff635a18110b4d1c7b280275ccd187823d88031efa71f815339736
|
|
BLAKE2b-256 checksum How to use checksums |
6102f0127d08e26a5be297982f8bd81a9b5f2cc8cc2e16b1f7c3501ffa8a8f04
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.3 {"installer":{"name":"uv","version":"0.13.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / neobot_chat-2.0.0a2-py3-none-any.whl
| Download URL | neobot_chat-2.0.0a2-py3-none-any.whl |
|---|---|
| Size | 68.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9c3c4a9daeede6c7c403b0f73b41f371343d7697c615e60903ca281de6dae043
|
|
BLAKE2b-256 checksum How to use checksums |
75b0941f8751eae2de5eead5c7c2eaf81ac749aebfa9a39079866675305ce6f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.3 {"installer":{"name":"uv","version":"0.13.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for neobot-chat 2.0.0a2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
