Agent wip

.gitignore

@@ -8,6 +8,10 @@
 **/.env
 **/*.sqlite
 **/*.vite
+**/.coverage
+**/.coverage.*
+**/htmlcov/
+**/coverage.xml
 fastapi_startkit/dist
 fastapi_startkit.github.io.git
 laravel-repo

example/database-app/app/models/category.py

@@ -1,7 +1,7 @@
 from typing import TYPE_CHECKING
 
 from fastapi_startkit.masoniteorm.models import Model
-from fastapi_startkit.masoniteorm.relationships import HasMany, HasManyThrough
+from fastapi_startkit.masoniteorm import HasMany, HasManyThrough
 
 if TYPE_CHECKING:
     from app.models.course import Course

example/database-app/app/models/course.py

@@ -1,7 +1,7 @@
 from typing import TYPE_CHECKING
 
 from fastapi_startkit.masoniteorm.models import Model
-from fastapi_startkit.masoniteorm.relationships import BelongsTo, HasMany, BelongsToMany, MorphMany
+from fastapi_startkit.masoniteorm import BelongsTo, HasMany, BelongsToMany, MorphMany
 
 if TYPE_CHECKING:
     from app.models.category import Category

example/database-app/app/models/lesson.py

@@ -1,7 +1,7 @@
 from typing import TYPE_CHECKING
 
 from fastapi_startkit.masoniteorm.models import Model
-from fastapi_startkit.masoniteorm.relationships import BelongsTo, MorphMany
+from fastapi_startkit.masoniteorm import BelongsTo, MorphMany
 
 if TYPE_CHECKING:
     from app.models.course import Course

example/database-app/app/models/profile.py

@@ -1,7 +1,7 @@
 from typing import TYPE_CHECKING
 
 from fastapi_startkit.masoniteorm.models import Model
-from fastapi_startkit.masoniteorm.relationships import BelongsTo
+from fastapi_startkit.masoniteorm import BelongsTo
 
 if TYPE_CHECKING:
     from app.models.user import User

example/database-app/app/models/review.py

@@ -1,7 +1,7 @@
 from typing import TYPE_CHECKING
 
 from fastapi_startkit.masoniteorm.models import Model
-from fastapi_startkit.masoniteorm.relationships import MorphTo
+from fastapi_startkit.masoniteorm import MorphTo
 
 class Review(Model):
     __table__ = "reviews"

example/database-app/app/models/user.py

@@ -1,7 +1,7 @@
 from typing import TYPE_CHECKING
 
 from fastapi_startkit.masoniteorm.models import Model
-from fastapi_startkit.masoniteorm.relationships import HasMany, HasOne, BelongsToMany
+from fastapi_startkit.masoniteorm import HasMany, HasOne, BelongsToMany
 
 if TYPE_CHECKING:
     from app.models.profile import Profile

example/vite-app/providers/fastapi_provider.py → example/vite-app/app/providers/fastapi_provider.py

@@ -1,7 +1,4 @@
-from pathlib import Path
-
 from fastapi import FastAPI
-from starlette.templating import Jinja2Templates
 
 from fastapi_startkit.fastapi import FastAPIProvider as BaseFastAPIProvider
 
@@ -14,11 +11,6 @@ def register(self) -> None:
         )
         self.app.use_fastapi(fastapi)
 
-        # Bind Jinja2Templates so ViteProvider can inject vite() globals into it.
-        templates_dir = Path(self.app.base_path) / "templates"
-        templates = Jinja2Templates(directory=str(templates_dir))
-        self.app.bind("templates", templates)
-
     def boot(self) -> None:
         super().boot()
 

example/vite-app/bootstrap/application.py

@@ -4,8 +4,7 @@
 from fastapi_startkit.logging import LogProvider
 from fastapi_startkit.vite import ViteProvider
 
-# from config.vite import ViteConfig
-from providers.fastapi_provider import FastAPIProvider
+from app.providers.fastapi_provider import FastAPIProvider
 
 app: Application = Application(
     base_path=Path(__file__).resolve().parent.parent,

example/vite-app/config/vite.py

@@ -10,3 +10,5 @@ class ViteConfig:
     asset_url: str = ""
     static_url: str = "/build"
     mount_static: bool = True
+    template: bool = True
+    templates_directory: str = "resources/templates"

example/vite-app/pyproject.toml

@@ -14,4 +14,7 @@ fastapi-startkit = { path = "../../fastapi_startkit", editable = true }
 [dependency-groups]
 dev = [
     "dumpdie>=1.5.0",
+    "httpx>=0.28.1",
+    "pytest>=9.0.3",
+    "pytest-asyncio>=1.3.0",
 ]

example/vite-app/pytest.ini

@@ -0,0 +1,3 @@
+[pytest]
+asyncio_mode = auto
+pythonpath = .

example/vite-app/routes/web.py

@@ -1,14 +1,14 @@
 from fastapi import APIRouter, Request
 from fastapi.responses import HTMLResponse
 
+from fastapi_startkit.application import app
+
 web = APIRouter()
 
 
 @web.get("/", response_class=HTMLResponse)
 async def index(request: Request):
-    from bootstrap.application import app
-
-    templates = app.make("templates")
+    templates = app().make("templates")
     return templates.TemplateResponse(request, "index.html")
 
 

example/vite-app/tests/test_case.py

@@ -0,0 +1,14 @@
+from abc import ABC
+from typing import TYPE_CHECKING
+
+from fastapi_startkit.testing import TestCase as BaseTestCase
+
+if TYPE_CHECKING:
+    from fastapi_startkit.application import Application
+
+
+class TestCase(BaseTestCase, ABC):
+    def get_application(self) -> "Application":
+        from bootstrap.application import app
+
+        return app

example/vite-app/tests/test_web_routes.py

@@ -0,0 +1,18 @@
+from fastapi_startkit.fastapi.testing import HttpTestCase
+
+from tests.test_case import TestCase
+
+
+class TestHomeController(TestCase, HttpTestCase):
+    async def test_health_endpoint_returns_ok(self):
+        response = await self.get("/api/health")
+
+        response.assert_ok()
+        assert response.json() == {"status": "healthy"}
+
+    async def test_index_page_renders(self):
+        response = await self.get("/")
+
+        response.assert_ok()
+        body = response.text
+        assert "FastAPI StartKit" in body

fastapi_startkit/pyproject.toml

@@ -51,6 +51,9 @@ ai = [
     "anthropic>=0.49.0",
     "openai>=1.0.0",
     "google-generativeai>=0.8.0",
+    "langchain>=1.0.0",
+    "langchain-core>=1.0.0",
+    "langgraph>=1.0.0",
 ]
 
 [dependency-groups]
@@ -68,6 +71,9 @@ dev = [
     "sqlalchemy[asyncio]>=2.0.38",
     "fastapi[standard]>=0.124.4",
     "faker>=40.13.0",
+    "langchain>=1.0.0",
+    "langchain-core>=1.0.0",
+    "langgraph>=1.0.0",
 ]
 
 

fastapi_startkit/src/fastapi_startkit/ai/__init__.py

@@ -1,27 +1,11 @@
-"""FastAPI Startkit AI module.
-
-Provides a LangGraph-powered declarative API for building AI agents backed
-by Anthropic, OpenAI, or Google provider SDKs.
-
-Also exposes a Laravel-style fluent API for image generation and text-to-speech::
-
-    from fastapi_startkit.ai import Image, Audio, Document
-
-    image = await Image.of("A donut on a counter").generate()
-
-    # With a photo attachment
-    doc = await Document.from_url("https://example.com/photo.jpg")
-    image = await Image.of("Make impressionist").attachments([doc]).generate()
-
-    audio = await Audio.of("Hello world").female().generate()
-"""
-
 from .agent import Agent
 from .audio import Audio, AudioResponse
 from .audio_factory import AudioFactory
-from .config import AIConfig, AnthropicConfig, GoogleConfig, OpenAIConfig
+from .config.config import AnthropicConfig, ElevenLabsConfig, GoogleConfig, OpenAIConfig
+from .config.ai import AIConfig
 from .decorators import max_steps, max_tokens, memory, model, provider, timeout, top_p
 from .document import Document
+from .fakes import fake_chat_model
 from .image import Image, ImageResponse
 from .image_factory import ImageFactory
 from .providers.ai_provider import AIProvider
@@ -38,6 +22,8 @@
     "AudioResponse",
     "AudioFactory",
     "Document",
+    "ElevenLabsConfig",
+    "fake_chat_model",
     "GoogleConfig",
     "Image",
     "ImageFactory",