feat: AI-powered task API with Ollama auto-prioritization

Author: JeffiN11

.env.example

@@ -0,0 +1,3 @@
+DATABASE_URL=postgresql+asyncpg://taskuser:taskpass@localhost:5432/taskdb
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_MODEL=llama3

.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Lint & Test
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('requirements*.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+          pip install ruff
+
+      - name: Lint with Ruff
+        run: ruff check app/ tests/
+
+      - name: Run tests
+        run: pytest --tb=short -v

.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.pyc
+*.pyo
+.env
+.venv/
+venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/

Dockerfile

@@ -0,0 +1,12 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+EXPOSE 8000
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -0,0 +1,39 @@
+# smart-task-api
+
+An AI-powered task management REST API built with FastAPI, PostgreSQL, and Ollama (llama3). Tasks are automatically prioritized (Low / Medium / High) by a locally-running LLM the moment they are created.
+
+## Tech Stack
+- FastAPI 0.115
+- PostgreSQL 16 + SQLAlchemy 2 (async)
+- Ollama + llama3 (local LLM)
+- Docker + Docker Compose
+- pytest + pytest-asyncio
+- GitHub Actions CI
+
+## Quick Start
+
+```bash
+docker compose up --build
+```
+
+API: http://localhost:8000
+Docs: http://localhost:8000/docs
+
+## Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | / | Health check |
+| POST | /tasks/ | Create task (AI prioritizes async) |
+| GET | /tasks/ | List tasks |
+| GET | /tasks/{id} | Get task |
+| PATCH | /tasks/{id} | Update task |
+| DELETE | /tasks/{id} | Delete task |
+| POST | /tasks/{id}/reprioritize | Force AI re-prioritization |
+
+## Run Tests
+
+```bash
+pip install -r requirements.txt -r requirements-dev.txt
+pytest -v
+```

app/__init__.py

@@ -0,0 +1,26 @@
+import os
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine, async_sessionmaker
+from sqlalchemy.orm import DeclarativeBase
+
+DATABASE_URL = os.getenv(
+    "DATABASE_URL",
+    "postgresql+asyncpg://taskuser:taskpass@localhost:5432/taskdb",
+)
+
+engine = create_async_engine(DATABASE_URL, echo=False)
+
+AsyncSessionLocal = async_sessionmaker(
+    engine, class_=AsyncSession, expire_on_commit=False
+)
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+async def get_db():
+    async with AsyncSessionLocal() as session:
+        try:
+            yield session
+        finally:
+            await session.close()

app/db/__init__.py

@@ -0,0 +1,40 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from contextlib import asynccontextmanager
+
+from app.db.database import engine, Base
+from app.routers import tasks
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+    yield
+
+
+app = FastAPI(
+    title="Smart Task API",
+    description="AI-powered task manager that auto-prioritizes tasks using a local LLM (Ollama).",
+    version="2.0.0",
+    lifespan=lifespan,
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+app.include_router(tasks.router, prefix="/tasks", tags=["Tasks"])
+
+
+@app.get("/", tags=["Health"])
+async def root():
+    return {"status": "ok", "message": "Smart Task API is running"}
+
+
+@app.get("/health", tags=["Health"])
+async def health():
+    return {"status": "healthy"}