forktex-intelligence 0.2.3__tar.gz

forktex_intelligence-0.2.3/LICENSE

@@ -0,0 +1,45 @@
+forktex-intelligence -- Dual License
+
+Copyright (C) 2026 FORKTEX S.R.L.
+
+This software is licensed under a dual-license model:
+
+============================================================================
+
+1. OPEN-SOURCE LICENSE -- GNU Affero General Public License v3.0 (AGPL-3.0)
+
+   You may use, modify, and redistribute this software under the terms of the
+   GNU Affero General Public License v3.0 or later, as published by the Free
+   Software Foundation. The full license text is available at:
+   https://www.gnu.org/licenses/agpl-3.0.html
+
+   Key obligations under AGPL-3.0:
+   - Any modified version MUST be released under the same AGPL-3.0 license.
+   - If you run a modified version on a server and let users interact with it
+     over a network, you MUST make the complete source code available to those
+     users under AGPL-3.0.
+   - You MUST preserve all copyright notices and attribution to FORKTEX S.R.L.
+
+============================================================================
+
+2. COMMERCIAL LICENSE
+
+   If you wish to use this software without the obligations of AGPL-3.0 --
+   for example, to keep your modifications proprietary, to embed this software
+   in a closed-source product, or to operate it as part of a commercial service
+   without releasing your source code -- you MUST obtain a commercial license
+   from FORKTEX S.R.L.
+
+   Commercial licensing includes, but is not limited to:
+   - SaaS / hosted deployments generating revenue
+   - Embedding in proprietary products or platforms
+   - Redistribution in closed-source form
+   - Use by organizations exceeding the AGPL-3.0 compliance scope
+
+   For commercial licensing inquiries, contact:
+     info@forktex.com
+
+============================================================================
+
+Unless you have obtained a separate commercial license from FORKTEX S.R.L.,
+your use of this software is governed exclusively by the AGPL-3.0 license.

forktex_intelligence-0.2.3/NOTICE

@@ -0,0 +1,22 @@
+forktex-intelligence
+Copyright (C) 2026 FORKTEX S.R.L.
+
+forktex-intelligence is the standalone Python SDK for the ForkTex Intelligence
+API. It provides the typed httpx-based client (sync + streaming over SSE),
+generated Pydantic models for the Intelligence OpenAPI surface, and helpers
+for chat, agent runs, embeddings, retrieval, and ecosystem indexing.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+For commercial licensing inquiries, contact: info@forktex.com

forktex_intelligence-0.2.3/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: forktex-intelligence
+Version: 0.2.3
+Summary: Standalone Python SDK for the ForkTex Intelligence API — chat, agent runs, embeddings, retrieval, ecosystem indexing
+License-Expression: AGPL-3.0-only
+License-File: LICENSE
+License-File: NOTICE
+Author: FORKTEX
+Author-email: info@forktex.com
+Requires-Python: >=3.12
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: httpx (>=0.27.0,<1.0.0)
+Requires-Dist: httpx-sse (>=0.4.0,<1.0.0)
+Requires-Dist: pydantic (>=2.11.10,<3.0.0)
+Project-URL: Bug Tracker, https://github.com/forktex/intelligence/issues
+Project-URL: Homepage, https://intelligence.forktex.com
+Project-URL: Repository, https://github.com/forktex/intelligence
+Description-Content-Type: text/markdown
+
+# forktex-intelligence
+
+[![PyPI](https://img.shields.io/pypi/v/forktex-intelligence.svg)](https://pypi.org/project/forktex-intelligence/)
+[![Python](https://img.shields.io/pypi/pyversions/forktex-intelligence.svg)](https://pypi.org/project/forktex-intelligence/)
+[![License](https://img.shields.io/pypi/l/forktex-intelligence.svg)](https://github.com/forktex/intelligence/blob/master/sdk-py/LICENSE)
+
+Standalone Python SDK for the [ForkTex Intelligence](https://intelligence.forktex.com) API.
+
+`forktex-intelligence` is the high-level Python client for the ForkTex Intelligence platform: multi-provider LLM chat (streaming + structured), embeddings, vector search, content extraction (PDF / DOCX / HTML), and image / audio generation. It backs the `forktex intelligence ask / run / scrape` CLI commands and is also usable directly from any Python application.
+
+## Install
+
+```bash
+pip install forktex-intelligence
+```
+
+**Requires Python 3.12+.** Tested on 3.12, 3.13, 3.14.
+
+## Quick Start
+
+### Single-shot prompt
+
+```python
+from forktex_intelligence import Intelligence
+
+async with Intelligence(endpoint="https://intelligence.forktex.com/api", api_key="sk-...") as ai:
+    response = await ai.chat("Summarize the ForkTex stack in one sentence.")
+    print(response.text)
+```
+
+### Structured response (Pydantic schema)
+
+```python
+from pydantic import BaseModel
+from forktex_intelligence import Intelligence
+
+class Summary(BaseModel):
+    title: str
+    bullets: list[str]
+
+async with Intelligence(endpoint="...", api_key="...") as ai:
+    result = await ai.extract_structured(
+        prompt="Summarize the ForkTex stack.",
+        schema=Summary,
+    )
+    print(result.parsed.title, result.parsed.bullets)
+```
+
+### Streaming
+
+```python
+from forktex_intelligence import Intelligence
+
+async with Intelligence(endpoint="...", api_key="...") as ai:
+    async for chunk in ai.stream("Tell me a story."):
+        print(chunk, end="", flush=True)
+```
+
+## Configuration
+
+Pass endpoint and API key explicitly:
+
+```python
+Intelligence(endpoint="https://intelligence.forktex.com/api", api_key="sk-...")
+```
+
+Or via an `IntelligenceSettings` object:
+
+```python
+from forktex_intelligence import IntelligenceSettings, Intelligence
+
+settings = IntelligenceSettings(endpoint="...", api_key="...")
+async with Intelligence(settings=settings) as ai:
+    ...
+```
+
+When used via the `forktex` CLI, settings are loaded from environment variables and `.forktex/` config files automatically.
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `FORKTEX_INTELLIGENCE_ENDPOINT` | Intelligence API endpoint | `https://intelligence.forktex.com/api` |
+| `FORKTEX_INTELLIGENCE_API_KEY` | Intelligence API key | *(required)* |
+
+### Local dev (point at your `make local` stack)
+
+```bash
+export FORKTEX_INTELLIGENCE_ENDPOINT=http://localhost:8001/api
+export FORKTEX_INTELLIGENCE_API_KEY=dev-key
+```
+
+Or programmatically:
+
+```python
+from forktex_intelligence import Intelligence
+intel = Intelligence(endpoint="http://localhost:8001/api", api_key="dev-key")
+```
+
+## What's in the package
+
+| Module | Purpose |
+|--------|---------|
+| `forktex_intelligence.api` | High-level `Intelligence` client (chat, structured, stream) |
+| `forktex_intelligence.client` | Low-level `ForktexIntelligenceClient` (raw HTTP, advanced use) |
+| `forktex_intelligence.client.generated` | Wire-level Pydantic models (`ChatMessage`, `ChatResponse`, …) generated from the OpenAPI spec |
+| `forktex_intelligence.streams` | SSE event types and parser |
+| `forktex_intelligence.config` | `IntelligenceSettings` — endpoint, API key |
+
+All response models come from the OpenAPI codegen pipeline — one source of truth shared between the server and every consumer.
+
+## Repository
+
+This SDK lives inside the [`forktex/intelligence`](https://github.com/forktex/intelligence) monorepo alongside the API server (`api/`). The SDK package is independently versioned and published to PyPI.
+
+## Development
+
+The [`Makefile`](Makefile) is generated by `forktex fsd makefile sync` from [`forktex.json`](forktex.json) — do not hand-edit.
+
+```bash
+make help              # list every available target
+make deps              # editable install with the dev group
+make format            # ruff format
+make lint              # ruff check
+make test              # pytest tests/
+make codegen-check     # verify the generated client imports cleanly
+make build             # python3 -m build → dist/
+make ci                # format-check + lint + license-check + audit + test + build
+make clean             # remove caches and dist/
+```
+
+`make ci` is the single command that gates a publish: format-check, lint, dual-license header check, dependency CVE audit, full test suite, and `python -m build` + `twine check`.
+
+### License headers
+
+Every source file carries the AGPL-3.0 + Commercial dual-license SPDX header, applied idempotently via:
+
+```bash
+make license-check    # CI gate — fails if any source file is missing the header
+make license-fix      # add or refresh headers across src/, tests/, scripts/
+make license-strip    # remove headers (used before license-model changes)
+```
+
+## License
+
+Dual-licensed — **AGPL-3.0-or-later** for open-source use, **commercial** for everything else (proprietary products, SaaS without source release, redistribution in closed-source form). See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE) for the full terms.
+
+Commercial licensing inquiries: info@forktex.com.
+
+The 1.0.0 release on PyPI remains under MIT; from **0.2.3** onwards the package ships AGPL-3.0+Commercial.
+

forktex_intelligence-0.2.3/README.md

@@ -0,0 +1,148 @@
+# forktex-intelligence
+
+[![PyPI](https://img.shields.io/pypi/v/forktex-intelligence.svg)](https://pypi.org/project/forktex-intelligence/)
+[![Python](https://img.shields.io/pypi/pyversions/forktex-intelligence.svg)](https://pypi.org/project/forktex-intelligence/)
+[![License](https://img.shields.io/pypi/l/forktex-intelligence.svg)](https://github.com/forktex/intelligence/blob/master/sdk-py/LICENSE)
+
+Standalone Python SDK for the [ForkTex Intelligence](https://intelligence.forktex.com) API.
+
+`forktex-intelligence` is the high-level Python client for the ForkTex Intelligence platform: multi-provider LLM chat (streaming + structured), embeddings, vector search, content extraction (PDF / DOCX / HTML), and image / audio generation. It backs the `forktex intelligence ask / run / scrape` CLI commands and is also usable directly from any Python application.
+
+## Install
+
+```bash
+pip install forktex-intelligence
+```
+
+**Requires Python 3.12+.** Tested on 3.12, 3.13, 3.14.
+
+## Quick Start
+
+### Single-shot prompt
+
+```python
+from forktex_intelligence import Intelligence
+
+async with Intelligence(endpoint="https://intelligence.forktex.com/api", api_key="sk-...") as ai:
+    response = await ai.chat("Summarize the ForkTex stack in one sentence.")
+    print(response.text)
+```
+
+### Structured response (Pydantic schema)
+
+```python
+from pydantic import BaseModel
+from forktex_intelligence import Intelligence
+
+class Summary(BaseModel):
+    title: str
+    bullets: list[str]
+
+async with Intelligence(endpoint="...", api_key="...") as ai:
+    result = await ai.extract_structured(
+        prompt="Summarize the ForkTex stack.",
+        schema=Summary,
+    )
+    print(result.parsed.title, result.parsed.bullets)
+```
+
+### Streaming
+
+```python
+from forktex_intelligence import Intelligence
+
+async with Intelligence(endpoint="...", api_key="...") as ai:
+    async for chunk in ai.stream("Tell me a story."):
+        print(chunk, end="", flush=True)
+```
+
+## Configuration
+
+Pass endpoint and API key explicitly:
+
+```python
+Intelligence(endpoint="https://intelligence.forktex.com/api", api_key="sk-...")
+```
+
+Or via an `IntelligenceSettings` object:
+
+```python
+from forktex_intelligence import IntelligenceSettings, Intelligence
+
+settings = IntelligenceSettings(endpoint="...", api_key="...")
+async with Intelligence(settings=settings) as ai:
+    ...
+```
+
+When used via the `forktex` CLI, settings are loaded from environment variables and `.forktex/` config files automatically.
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `FORKTEX_INTELLIGENCE_ENDPOINT` | Intelligence API endpoint | `https://intelligence.forktex.com/api` |
+| `FORKTEX_INTELLIGENCE_API_KEY` | Intelligence API key | *(required)* |
+
+### Local dev (point at your `make local` stack)
+
+```bash
+export FORKTEX_INTELLIGENCE_ENDPOINT=http://localhost:8001/api
+export FORKTEX_INTELLIGENCE_API_KEY=dev-key
+```
+
+Or programmatically:
+
+```python
+from forktex_intelligence import Intelligence
+intel = Intelligence(endpoint="http://localhost:8001/api", api_key="dev-key")
+```
+
+## What's in the package
+
+| Module | Purpose |
+|--------|---------|
+| `forktex_intelligence.api` | High-level `Intelligence` client (chat, structured, stream) |
+| `forktex_intelligence.client` | Low-level `ForktexIntelligenceClient` (raw HTTP, advanced use) |
+| `forktex_intelligence.client.generated` | Wire-level Pydantic models (`ChatMessage`, `ChatResponse`, …) generated from the OpenAPI spec |
+| `forktex_intelligence.streams` | SSE event types and parser |
+| `forktex_intelligence.config` | `IntelligenceSettings` — endpoint, API key |
+
+All response models come from the OpenAPI codegen pipeline — one source of truth shared between the server and every consumer.
+
+## Repository
+
+This SDK lives inside the [`forktex/intelligence`](https://github.com/forktex/intelligence) monorepo alongside the API server (`api/`). The SDK package is independently versioned and published to PyPI.
+
+## Development
+
+The [`Makefile`](Makefile) is generated by `forktex fsd makefile sync` from [`forktex.json`](forktex.json) — do not hand-edit.
+
+```bash
+make help              # list every available target
+make deps              # editable install with the dev group
+make format            # ruff format
+make lint              # ruff check
+make test              # pytest tests/
+make codegen-check     # verify the generated client imports cleanly
+make build             # python3 -m build → dist/
+make ci                # format-check + lint + license-check + audit + test + build
+make clean             # remove caches and dist/
+```
+
+`make ci` is the single command that gates a publish: format-check, lint, dual-license header check, dependency CVE audit, full test suite, and `python -m build` + `twine check`.
+
+### License headers
+
+Every source file carries the AGPL-3.0 + Commercial dual-license SPDX header, applied idempotently via:
+
+```bash
+make license-check    # CI gate — fails if any source file is missing the header
+make license-fix      # add or refresh headers across src/, tests/, scripts/
+make license-strip    # remove headers (used before license-model changes)
+```
+
+## License
+
+Dual-licensed — **AGPL-3.0-or-later** for open-source use, **commercial** for everything else (proprietary products, SaaS without source release, redistribution in closed-source form). See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE) for the full terms.
+
+Commercial licensing inquiries: info@forktex.com.
+
+The 1.0.0 release on PyPI remains under MIT; from **0.2.3** onwards the package ships AGPL-3.0+Commercial.

forktex_intelligence-0.2.3/pyproject.toml

@@ -0,0 +1,84 @@
+# Copyright (C) 2026 FORKTEX S.R.L.
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
+#
+# This file is part of forktex-intelligence.
+#
+# For commercial licensing -- including use in proprietary products, SaaS
+# deployments, or any context where AGPL obligations cannot be met -- you
+# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+[project]
+name = "forktex-intelligence"
+version = "0.2.3"
+description = "Standalone Python SDK for the ForkTex Intelligence API — chat, agent runs, embeddings, retrieval, ecosystem indexing"
+authors = [
+    {name = "FORKTEX", email = "info@forktex.com"}
+]
+readme = "README.md"
+license = "AGPL-3.0-only"
+license-files = ["LICENSE", "NOTICE"]
+requires-python = ">=3.12"
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pydantic (>=2.11.10,<3.0.0)",
+    "httpx (>=0.27.0,<1.0.0)",
+    "httpx-sse (>=0.4.0,<1.0.0)",
+]
+
+[project.urls]
+"Homepage" = "https://intelligence.forktex.com"
+"Repository" = "https://github.com/forktex/intelligence"
+"Bug Tracker" = "https://github.com/forktex/intelligence/issues"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[dependency-groups]
+dev = [
+    "pytest (>=8.4.2,<9.0.0)",
+    "pytest-asyncio (>=1.2.0,<2.0.0)",
+    "ruff (>=0.8.0)",
+    "respx (>=0.21.0)",
+    "pyright>=1.1.350",
+    "pip-audit>=2.7.0",
+    "build>=1.2.0",
+    "twine>=5.0.0",
+]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 120
+extend-exclude = [
+    "src/forktex_intelligence/client/generated/**",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

forktex_intelligence-0.2.3/src/forktex_intelligence/__init__.py

@@ -0,0 +1,97 @@
+# Copyright (C) 2026 FORKTEX S.R.L.
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
+#
+# This file is part of forktex-intelligence.
+#
+# For commercial licensing -- including use in proprietary products, SaaS
+# deployments, or any context where AGPL obligations cannot be met -- you
+# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+"""forktex_intelligence — Standalone Python SDK for the ForkTex Intelligence API.
+
+Three pillars:
+  1. Smart API — LLM chat/structured output, proxied to best providers
+  2. Content Extraction — Upload any file, get structured text + chunks
+  3. Vector Space — Managed vector storage with semantic search
+
+Usage::
+
+    from forktex_intelligence import Intelligence
+
+    async with Intelligence(org_id="my-org-uuid") as ai:
+        # Chat
+        response = await ai.chat("Explain Python decorators")
+
+        # Extract text from a file
+        result = await ai.extract_file(pdf_bytes, "paper.pdf")
+
+        # Search across collections
+        results = await ai.search("collection-id", "quantum computing")
+"""
+
+__version__ = "0.2.3"
+
+from forktex_intelligence.api import (
+    AvailableModel,
+    Intelligence,
+    Response,
+    StructuredResponse,
+    StreamChunks,
+)
+from forktex_intelligence.config import IntelligenceSettings
+from forktex_intelligence.client.client import (
+    ForktexIntelligenceClient,
+    IntelligenceAPIError,
+)
+from forktex_intelligence.client.generated import (
+    SPEC_HASH,
+    SPEC_VERSION,
+    ChatMessage,
+    ChatResponse,
+    HealthResponse,
+    StructuredChatResponse,
+    ToolCallInfo,
+    UsageInfo,
+)
+from forktex_intelligence.streams import SSEEvent, SSEEventType
+
+__all__ = [
+    # High-level API
+    "AvailableModel",
+    "Intelligence",
+    "Response",
+    "StructuredResponse",
+    "StreamChunks",
+    # Configuration
+    "IntelligenceSettings",
+    # Low-level client (advanced)
+    "ForktexIntelligenceClient",
+    "IntelligenceAPIError",
+    # Codegen contract (wire-compatibility markers)
+    "SPEC_VERSION",
+    "SPEC_HASH",
+    # Wire-level models (advanced — prefer high-level API)
+    "ChatMessage",
+    "ChatResponse",
+    "HealthResponse",
+    "StructuredChatResponse",
+    "ToolCallInfo",
+    "UsageInfo",
+    # Streaming
+    "SSEEvent",
+    "SSEEventType",
+]