django-auto-agent 0.1.0__tar.gz

django_auto_agent-0.1.0/LICENSE

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

django_auto_agent-0.1.0/MANIFEST.in

@@ -0,0 +1,6 @@
+recursive-include ai_agent/templates *
+recursive-include ai_agent/migrations *
+include ai_agent/Dockerfile
+prune ai_agent/tests
+global-exclude *.pyc
+recursive-exclude * __pycache__

django_auto_agent-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: django-auto-agent
+Version: 0.1.0
+Summary: Django reusable app: DRF-to-LangGraph agent bridge with long-term memory.
+Author: Alireza fz
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/alirezafz/django-auto-agent
+Project-URL: Repository, https://github.com/alirezafz/django-auto-agent
+Project-URL: Issues, https://github.com/alirezafz/django-auto-agent/issues
+Keywords: django,djangorestframework,langgraph,agent,copilotkit
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=4.2
+Requires-Dist: djangorestframework
+Requires-Dist: drf-spectacular
+Requires-Dist: fastapi
+Requires-Dist: langchain>=1.0.0
+Requires-Dist: langchain-openai>=1.0.0
+Requires-Dist: langgraph>=1.0.0
+Requires-Dist: langgraph-checkpoint-postgres>=2.0.0
+Requires-Dist: langgraph-sdk>=0.1.61
+Requires-Dist: langmem>=0.0.29
+Requires-Dist: psycopg[binary]>=3.1.0
+Requires-Dist: psycopg-pool>=3.2.0
+Requires-Dist: copilotkit>=0.1.96
+Provides-Extra: redis
+Requires-Dist: redis>=5.0.0; extra == "redis"
+Requires-Dist: langgraph-checkpoint-redis; extra == "redis"
+Dynamic: license-file
+
+# django-auto-agent
+
+Django reusable app that turns opted-in DRF endpoints into a LangGraph supervisor, with optional long-term memory, admin views, and evals.
+
+Import name: `ai_agent`.
+
+## Install
+
+```bash
+pip install django-auto-agent
+```
+
+Redis-backed memory store (optional):
+
+```bash
+pip install "django-auto-agent[redis]"
+```
+
+From a clone of this repository:
+
+```bash
+pip install -e .
+pip install -e ".[redis]"
+```
+
+## Host wiring
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "ai_agent",
+    "catalog",  # your domain app
+]
+
+AI_AGENT = {
+    "SUPERVISOR_MODEL": "openai:gpt-4.1-mini",
+    "SUBAGENT_MODEL": "openai:gpt-4.1-nano",
+    "AUTHENTICATE_TOKEN": "myproject.auth.authenticate_access_token",
+    "PLATFORM_NAME": "Acme",
+    "PLATFORM_DOMAINS": ("catalog", "billing"),
+    "EVAL_MODULE": "catalog.evals",
+}
+```
+
+`AUTHENTICATE_TOKEN` is required. It must be a callable (or dotted path to one) that accepts a bearer token and returns a user object with `.pk`.
+
+Optional evals — point `EVAL_MODULE` at a host module that defines:
+
+- `seed_eval_world() -> EvalWorld` (users plus `prompt_vars` for case prompts)
+- `snapshot_world(world, kind) -> dict` (optional; used by mutation cases)
+- `CASES: list[EvalCase]` (or partitioned `ROUTING_CASES` / `TOOL_CASES` / `MUTATION_CASES` / `E2E_CASES`)
+
+The library always includes safety routing cases (off-policy greeting, jailbreaks). Domain tool and mutation cases come from the host module. See `dummy/evals.py` in this repo.
+
+`HTTP_TRUSTED_PROXY_COUNT` (default `0`) controls whether the CopilotKit HTTP throttle reads `X-Forwarded-For`. Leave it at `0` unless the app sits behind that many trusted reverse proxies; otherwise clients can rotate a spoofed header and bypass the limit.
+
+Include the chat/memory HTTP API:
+
+```python
+urlpatterns = [
+    path("api/agent/", include("ai_agent.urls")),
+]
+```
+
+Opt a host app into the agent by setting flags on its `AppConfig`:
+
+```python
+class CatalogConfig(AppConfig):
+    name = "catalog"
+    agent_expose = True
+    agent_description = "List and create catalog items for the authenticated user."
+    agent_exclude = ("internal_webhook",)
+    agent_memory_profile = "catalog.memory_schemas.CatalogProfile"
+    agent_memory_collections = (
+        "ai_agent.memory.schemas.SemanticFact",
+        "catalog.memory_schemas.CatalogAccount",
+    )
+```
+
+Mark individual views even when the app is off:
+
+```python
+from ai_agent.expose import agent_expose, agent_exclude
+
+@agent_expose
+def public_note(request):
+    ...
+```
+
+## LangGraph Agent Server
+
+This package is not a host Docker image. Install `django-auto-agent` **and** your Django project into the Agent Server image, then point `langgraph.json` at the library entrypoints (see the example `langgraph.json` in this repo):
+
+- graphs: `ai_agent.studio:graph`, `ai_agent.studio:memory`
+- auth: `ai_agent.auth:auth`
+- HTTP app: `ai_agent.studio:app`
+
+Set `DJANGO_SETTINGS_MODULE` (or `AI_AGENT_STUDIO_DJANGO_SETTINGS`) to **your** settings module before starting Studio.
+
+The example `langgraph.json` uses `cors.allow_origins: ["*"]`. Auth is Bearer-token based (not cookies), so CSRF exposure is limited; restrict origins in production.
+
+## Tests
+
+From this repo:
+
+```bash
+python manage.py test ai_agent
+```
+
+The `dummy` and `notes` apps plus `tests/settings.py` are a sample host. They are not installed with the wheel.

django_auto_agent-0.1.0/README.md

@@ -0,0 +1,110 @@
+# django-auto-agent
+
+Django reusable app that turns opted-in DRF endpoints into a LangGraph supervisor, with optional long-term memory, admin views, and evals.
+
+Import name: `ai_agent`.
+
+## Install
+
+```bash
+pip install django-auto-agent
+```
+
+Redis-backed memory store (optional):
+
+```bash
+pip install "django-auto-agent[redis]"
+```
+
+From a clone of this repository:
+
+```bash
+pip install -e .
+pip install -e ".[redis]"
+```
+
+## Host wiring
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "ai_agent",
+    "catalog",  # your domain app
+]
+
+AI_AGENT = {
+    "SUPERVISOR_MODEL": "openai:gpt-4.1-mini",
+    "SUBAGENT_MODEL": "openai:gpt-4.1-nano",
+    "AUTHENTICATE_TOKEN": "myproject.auth.authenticate_access_token",
+    "PLATFORM_NAME": "Acme",
+    "PLATFORM_DOMAINS": ("catalog", "billing"),
+    "EVAL_MODULE": "catalog.evals",
+}
+```
+
+`AUTHENTICATE_TOKEN` is required. It must be a callable (or dotted path to one) that accepts a bearer token and returns a user object with `.pk`.
+
+Optional evals — point `EVAL_MODULE` at a host module that defines:
+
+- `seed_eval_world() -> EvalWorld` (users plus `prompt_vars` for case prompts)
+- `snapshot_world(world, kind) -> dict` (optional; used by mutation cases)
+- `CASES: list[EvalCase]` (or partitioned `ROUTING_CASES` / `TOOL_CASES` / `MUTATION_CASES` / `E2E_CASES`)
+
+The library always includes safety routing cases (off-policy greeting, jailbreaks). Domain tool and mutation cases come from the host module. See `dummy/evals.py` in this repo.
+
+`HTTP_TRUSTED_PROXY_COUNT` (default `0`) controls whether the CopilotKit HTTP throttle reads `X-Forwarded-For`. Leave it at `0` unless the app sits behind that many trusted reverse proxies; otherwise clients can rotate a spoofed header and bypass the limit.
+
+Include the chat/memory HTTP API:
+
+```python
+urlpatterns = [
+    path("api/agent/", include("ai_agent.urls")),
+]
+```
+
+Opt a host app into the agent by setting flags on its `AppConfig`:
+
+```python
+class CatalogConfig(AppConfig):
+    name = "catalog"
+    agent_expose = True
+    agent_description = "List and create catalog items for the authenticated user."
+    agent_exclude = ("internal_webhook",)
+    agent_memory_profile = "catalog.memory_schemas.CatalogProfile"
+    agent_memory_collections = (
+        "ai_agent.memory.schemas.SemanticFact",
+        "catalog.memory_schemas.CatalogAccount",
+    )
+```
+
+Mark individual views even when the app is off:
+
+```python
+from ai_agent.expose import agent_expose, agent_exclude
+
+@agent_expose
+def public_note(request):
+    ...
+```
+
+## LangGraph Agent Server
+
+This package is not a host Docker image. Install `django-auto-agent` **and** your Django project into the Agent Server image, then point `langgraph.json` at the library entrypoints (see the example `langgraph.json` in this repo):
+
+- graphs: `ai_agent.studio:graph`, `ai_agent.studio:memory`
+- auth: `ai_agent.auth:auth`
+- HTTP app: `ai_agent.studio:app`
+
+Set `DJANGO_SETTINGS_MODULE` (or `AI_AGENT_STUDIO_DJANGO_SETTINGS`) to **your** settings module before starting Studio.
+
+The example `langgraph.json` uses `cors.allow_origins: ["*"]`. Auth is Bearer-token based (not cookies), so CSRF exposure is limited; restrict origins in production.
+
+## Tests
+
+From this repo:
+
+```bash
+python manage.py test ai_agent
+```
+
+The `dummy` and `notes` apps plus `tests/settings.py` are a sample host. They are not installed with the wheel.

django_auto_agent-0.1.0/ai_agent/Dockerfile

@@ -0,0 +1,12 @@
+# Example only. django-auto-agent is a pip library, not a host image.
+#
+# Build the LangGraph Agent Server from YOUR Django project:
+#   1. pip install django-auto-agent
+#   2. COPY your Django project into the image
+#   3. Set DJANGO_SETTINGS_MODULE to your settings
+#   4. Point langgraph.json at ai_agent.studio and ai_agent.auth
+#
+# See README.md and the example langgraph.json in this repository.
+
+FROM langchain/langgraph-api:3.11-bookworm
+RUN echo "Install django-auto-agent and your Django host project; do not copy a product tree into this library."

django_auto_agent-0.1.0/ai_agent/__init__.py

@@ -0,0 +1,9 @@
+"""Opt-in DRF-to-LangGraph agent bridge.
+
+Extractable surface: expose, discovery, schema, executor, tools, graph, context.
+Product wiring (chat view, Django settings) stays in this app.
+"""
+
+from ai_agent.expose import agent_exclude, agent_expose
+
+__all__ = ["agent_expose", "agent_exclude"]

django_auto_agent-0.1.0/ai_agent/admin/__init__.py

@@ -0,0 +1,9 @@
+"""ai_agent admin package.
+
+Model -> file map:
+  AgentThread -> threads.py
+  AgentMemory -> memories.py
+  AgentPrompt -> prompts.py
+  AgentMessage -> messages.py
+"""
+from . import memories, messages, prompts, threads  # noqa: F401

django_auto_agent-0.1.0/ai_agent/admin/_helpers.py

@@ -0,0 +1,68 @@
+"""Shared presentation helpers for AI agent admin views."""
+
+from __future__ import annotations
+
+from django.core.paginator import EmptyPage, Paginator
+from django.urls import NoReverseMatch, reverse
+
+
+def user_display_name(user) -> str:
+    """Prefer first/last name, then ``get_username()``."""
+    if user is None:
+        return ""
+    name = " ".join(
+        part
+        for part in (getattr(user, "first_name", None), getattr(user, "last_name", None))
+        if part
+    )
+    if name:
+        return name
+    getter = getattr(user, "get_username", None)
+    if callable(getter):
+        return str(getter() or "").strip()
+    return ""
+
+
+def user_change_url(user) -> str:
+    """Django admin change URL for the configured user model."""
+    if user is None:
+        return ""
+    opts = user._meta
+    try:
+        return reverse(
+            f"admin:{opts.app_label}_{opts.model_name}_change",
+            args=[user.pk],
+        )
+    except NoReverseMatch:
+        return ""
+
+
+def paginate(request, items, total: int, *, per_page: int = 25):
+    """Build a Django page from an already-sliced list plus a known total."""
+    paginator = Paginator(range(total), per_page)
+    page_number = request.GET.get("p") or 1
+    try:
+        page = paginator.page(page_number)
+    except EmptyPage:
+        page = paginator.page(paginator.num_pages or 1)
+    page.object_list = items
+    return page, paginator
+
+
+def page_offset(request, *, per_page: int = 25) -> int:
+    try:
+        page_number = int(request.GET.get("p") or 1)
+    except (TypeError, ValueError):
+        page_number = 1
+    if page_number < 1:
+        page_number = 1
+    return (page_number - 1) * per_page
+
+
+def safe_next(raw: str, fallback: str) -> str:
+    """Allow only a relative query string on the same admin path."""
+    value = (raw or "").strip()
+    path, _, _ = fallback.partition("?")
+    if value.startswith("?") and "://" not in value and "\n" not in value:
+        return path + value
+    return fallback