02: backend-setup

.gitignore

@@ -0,0 +1,72 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg
+*.egg-info/
+dist/
+build/
+eggs/
+parts/
+var/
+sdist/
+develop-eggs/
+.installed.cfg
+lib/
+lib64/
+
+# Virtual Environment
+venv/
+.venv/
+env/
+ENV/
+
+# Environment Variables
+.env
+.env.local
+.env.development
+.env.production
+
+# Next.js
+.next/
+out/
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Build
+dist/
+build/
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Logs
+logs/
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# IDE
+.vscode/settings.json
+.idea/
+*.swp
+*.swo
+
+# Exports
+backend/exports/
+
+# Prisma
+prisma/dev.db
+
+# pnpm
+.pnpm-store/

backend/.env

@@ -0,0 +1,18 @@
+APP_NAME=Inferix
+APP_ENV=development
+APP_PORT=8000
+DEBUG=True
+
+DATABASE_URL=postgresql://dummy:dummy@localhost/inferix
+
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_MODEL_1=gemma:2b
+OLLAMA_MODEL_2=phi3:mini
+OLLAMA_MODEL_3=llama3.2:3b
+
+CLERK_SECRET_KEY=dummy_secret_key
+CLERK_PUBLISHABLE_KEY=dummy_publishable_key
+
+ALLOWED_ORIGINS=http://localhost:3000
+
+EXPORT_DIR=./exports

backend/.env.example

@@ -0,0 +1,24 @@
+# App
+APP_NAME=Inferix
+APP_ENV=development
+APP_PORT=8000
+DEBUG=True
+
+# Database — NeonDB
+DATABASE_URL=your_neondb_connection_string_here
+
+# Ollama
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_MODEL_1=gemma:2b
+OLLAMA_MODEL_2=phi3:mini
+OLLAMA_MODEL_3=llama3.2:3b
+
+# Auth — Clerk
+CLERK_SECRET_KEY=your_clerk_secret_key_here
+CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key_here
+
+# CORS
+ALLOWED_ORIGINS=http://localhost:3000
+
+# Export
+EXPORT_DIR=./exports

backend/app/core/config.py

@@ -0,0 +1,40 @@
+from pydantic_settings import BaseSettings
+from typing import List
+
+class Settings(BaseSettings):
+    # App
+    APP_NAME: str = "Inferix"
+    APP_ENV: str = "development"
+    APP_PORT: int = 8000
+    DEBUG: bool = True
+
+    # Database
+    DATABASE_URL: str
+
+    # Ollama
+    OLLAMA_BASE_URL: str = "http://localhost:11434"
+    OLLAMA_MODEL_1: str = "gemma:2b"
+    OLLAMA_MODEL_2: str = "phi3:mini"
+    OLLAMA_MODEL_3: str = "llama3.2:3b"
+
+    # Auth - Clerk
+    CLERK_SECRET_KEY: str
+    CLERK_PUBLISHABLE_KEY: str
+
+    # CORS
+    ALLOWED_ORIGINS: str = "http://localhost:3000"
+
+    # Export
+    EXPORT_DIR: str = "./exports"
+
+    @property
+    def OLLAMA_MODELS(self) -> List[str]:
+        return [
+            self.OLLAMA_MODEL_1,
+            self.OLLAMA_MODEL_2,
+            self.OLLAMA_MODEL_3
+        ]
+
+    model_config = {"env_file": ".env", "extra": "ignore"}
+
+settings = Settings()

backend/app/routers/ai.py

@@ -0,0 +1,3 @@
+from fastapi import APIRouter
+
+router = APIRouter()

backend/app/routers/benchmark.py

@@ -0,0 +1,3 @@
+from fastapi import APIRouter
+
+router = APIRouter()

backend/app/routers/chat.py

@@ -0,0 +1,3 @@
+from fastapi import APIRouter
+
+router = APIRouter()

backend/app/routers/compare.py

@@ -0,0 +1,3 @@
+from fastapi import APIRouter
+
+router = APIRouter()

backend/app/routers/export.py

@@ -0,0 +1,3 @@
+from fastapi import APIRouter
+
+router = APIRouter()

backend/app/routers/models.py

@@ -0,0 +1,3 @@
+from fastapi import APIRouter
+
+router = APIRouter()

backend/app/routers/report.py

@@ -0,0 +1,3 @@
+from fastapi import APIRouter
+
+router = APIRouter()

backend/app/routers/templates.py

@@ -0,0 +1,3 @@
+from fastapi import APIRouter
+
+router = APIRouter()

backend/app/routers/voice.py

@@ -0,0 +1,3 @@
+from fastapi import APIRouter
+
+router = APIRouter()

backend/main.py

@@ -0,0 +1,56 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from contextlib import asynccontextmanager
+from app.core.config import settings
+from app.routers import (
+    chat, benchmark, compare,
+    models, templates, report,
+    export, ai, voice
+)
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    print(f"🚀 Inferix Backend starting on port {settings.APP_PORT}")
+    print(f"🤖 Ollama URL: {settings.OLLAMA_BASE_URL}")
+    yield
+    print("🛑 Inferix Backend shutting down...")
+
+app = FastAPI(
+    title="Inferix API",
+    description="Privacy-first, offline AI playground backend",
+    version="0.1.0",
+    lifespan=lifespan
+)
+
+# CORS
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=[settings.ALLOWED_ORIGINS],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Routers
+app.include_router(chat.router,       prefix="/api/chat",      tags=["Chat"])
+app.include_router(benchmark.router,  prefix="/api/benchmark", tags=["Benchmark"])
+app.include_router(compare.router,    prefix="/api/compare",   tags=["Compare"])
+app.include_router(models.router,     prefix="/api/models",    tags=["Models"])
+app.include_router(templates.router,  prefix="/api/templates", tags=["Templates"])
+app.include_router(report.router,     prefix="/api/report",    tags=["Report"])
+app.include_router(export.router,     prefix="/api/export",    tags=["Export"])
+app.include_router(ai.router,         prefix="/api/ai",        tags=["AI"])
+app.include_router(voice.router,      prefix="/api/voice",     tags=["Voice"])
+
+@app.get("/")
+async def root():
+    return {
+        "app": "Inferix",
+        "version": "0.1.0",
+        "status": "running",
+        "docs": "/docs"
+    }
+
+@app.get("/health")
+async def health():
+    return {"status": "healthy"}

backend/requirements.txt

@@ -0,0 +1,32 @@
+# Framework
+fastapi
+uvicorn[standard]
+
+# LangChain + Ollama
+langchain
+langchain-ollama
+langchain-community
+
+# Database
+prisma
+asyncpg
+
+# AI/ML
+psutil
+
+# Auth
+python-jose[cryptography]
+httpx
+
+# Utils
+python-dotenv
+python-multipart
+pydantic
+pydantic-settings
+
+# Export
+reportlab
+markdown
+
+# Voice
+SpeechRecognition