chore: ran linter & formatter again

Reviewed-on: francwa/agent_media#8

.bumpversion.toml

@@ -1,5 +1,5 @@
 [tool.bumpversion]
-current_version = "0.1.1"
+current_version = "0.1.6"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 search = "{current_version}"

.dockerignore

@@ -41,10 +41,6 @@ docs/
 *.md
 !README.md
 
-# Tests
-tests/
-pytest.ini
-
 # Data (will be mounted as volumes)
 memory_data/
 logs/

.env.example

@@ -1,69 +1,32 @@
-# Agent Media - Environment Variables
-
-# LibreChat Security Keys
-# Generate secure keys with: openssl rand -base64 32
-JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
-JWT_REFRESH_SECRET=your-super-secret-refresh-key-change-this-too
-
-# Generate with: openssl rand -hex 16 (for CREDS_KEY)
-CREDS_KEY=your-32-character-secret-key-here
-
-# Generate with: openssl rand -hex 8 (for CREDS_IV)
-CREDS_IV=your-16-character-iv-here
-
-# LibreChat Configuration
-DOMAIN_CLIENT=http://localhost:3080
-DOMAIN_SERVER=http://localhost:3080
-
-# Session expiry (in milliseconds)
-# Default: 15 minutes
-SESSION_EXPIRY=900000
-
-# Refresh token expiry (in milliseconds)
-# Default: 7 days
-REFRESH_TOKEN_EXPIRY=604800000
-
-# Meilisearch Configuration
-# Master key for Meilisearch (generate with: openssl rand -base64 32)
-MEILI_MASTER_KEY=DrhYf7zENyR6AlUCKmnz0eYASOQdl6zxH7s7MKFSfFU
-
-# PostgreSQL Configuration (for RAG API)
-POSTGRES_DB=librechat_rag
-POSTGRES_USER=postgres
-POSTGRES_PASSWORD=postgres
-
-# RAG API Configuration (Vector Database)
-RAG_COLLECTION_NAME=testcollection
-RAG_EMBEDDINGS_PROVIDER=openai
-RAG_EMBEDDINGS_MODEL=text-embedding-3-small
-
 # API Keys
-# OpenAI API Key (required for RAG embeddings)
+# Deepseek API Key (for LLM in alfred)
-OPENAI_API_KEY=your-openai-api-key-here
+DEEPSEEK_API_KEY=
 
-# Deepseek API Key (for LLM in agent-brain)
+OLLAMA_BASE_URL=
-DEEPSEEK_API_KEY=your-deepseek-api-key-here
+OLLAMA_MODEL=
-
-# Agent Brain Configuration
 
+# Alfred Configuration
 # LLM Provider (deepseek or ollama)
 LLM_PROVIDER=deepseek
 
 # Memory storage directory (inside container)
-MEMORY_STORAGE_DIR=/data/memory
+MEMORY_STORAGE_DIR=data/memory
-
-# API Key for agent-brain (used by LibreChat custom endpoint)
-AGENT_BRAIN_API_KEY=agent-brain-secret-key
 
 # External Services (Optional)
 # TMDB API Key (for movie metadata)
-TMDB_API_KEY=your-tmdb-key
+TMDB_API_KEY=
 
 # qBittorrent Configuration
-QBITTORRENT_URL=http://localhost:8080
+QBITTORRENT_URL=
 QBITTORRENT_USERNAME=admin
-QBITTORRENT_PASSWORD=adminpass
+QBITTORRENT_PASSWORD=adminadmin
 
 # Debug Options
 DEBUG_LOGGING=false
 DEBUG_CONSOLE=false
+
+# Required security keys
+JWT_SECRET=
+JWT_REFRESH_SECRET=
+CREDS_KEY=
+CREDS_IV=

.gitea/workflows/ci.yml

@@ -0,0 +1,89 @@
+name: CI/CD Awesome Pipeline
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+  workflow_dispatch:
+
+env:
+  REGISTRY_URL: ${{ vars.REGISTRY_URL || 'gitea.iswearihadsomethingforthis.net' }}
+  REGISTRY_USER: ${{ vars.REGISTRY_USER || 'francwa' }}
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Build and run tests
+        env:
+          DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
+          TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}
+        run: make _ci-run-tests
+
+  build-and-push:
+    name: Build & Push to Registry
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Load config from Makefile
+        id: config
+        run: make -s _ci-dump-config >> $GITHUB_OUTPUT
+
+      - name: 🏷️ Docker Metadata (Tags & Labels)
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: gitea.iswearihadsomethingforthis.net/francwa/${{ steps.config.outputs.image_name }}
+          tags: |
+            # Tagged (v1.2.3)
+            type=semver,pattern={{ version }}
+            # Latest (main)
+            type=raw,value=latest,enable={{ is_default_branch }}
+            # Feature branches
+            type=ref,event=branch
+
+      - name: Login to Gitea Registry
+        uses: docker/login-action@v3
+        with:
+          registry: gitea.iswearihadsomethingforthis.net
+          username: ${{ gitea.actor }}
+          password: ${{ secrets.G1T34_TOKEN }}
+
+      - name: Build and push
+        id: docker_build
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            PYTHON_VERSION=${{ steps.config.outputs.python_version }}
+            PYTHON_VERSION_SHORT=${{ steps.config.outputs.python_version_short }}
+            RUNNER=${{ steps.config.outputs.runner }}
+
+      - name: 🛡️ Run Trivy Vulnerability Scanner
+        uses: docker://aquasec/trivy:latest
+        env:
+          TRIVY_USERNAME: ${{ gitea.actor }}
+          TRIVY_PASSWORD: ${{ secrets.G1T34_TOKEN }}
+          # Unset the fake GITHUB_TOKEN injected by Gitea
+          GITHUB_TOKEN: ""
+        with:
+          args: image --format table --output trivy-report.txt --exit-code 0 --ignore-unfixed --severity CRITICAL,HIGH gitea.iswearihadsomethingforthis.net/francwa/${{ steps.config.outputs.image_name }}:latest
+
+      - name: 📤 Upload Security Report
+        uses: actions/upload-artifact@v3
+        with:
+          name: security-report
+          path: trivy-report.txt
+          retention-days: 7

.gitea/workflows/renovate.yaml

@@ -0,0 +1,22 @@
+name: Renovate Bot
+
+on:
+  schedule:
+    # Every Monday 4AM
+    - cron: '0 4 * * 1'
+  workflow_dispatch:
+
+jobs:
+  renovate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Run Renovate
+        uses: docker://renovate/renovate:latest
+        env:
+          RENOVATE_PLATFORM: "gitea"
+          RENOVATE_ENDPOINT: "https://gitea.iswearihadsomethingforthis.net/api/v1"
+          RENOVATE_TOKEN: "${{ secrets.RENOVATE_TOKEN }}"
+          RENOVATE_REPOSITORIES: '["${{ gitea.repository }}"]'
+          RENOVATE_GIT_AUTHOR: "Renovate Bot <renovate@bot.local>"
+          # Might need a free github token if lots of depencies
+          # RENOVATE_GITHUB_TOKEN: "${{ secrets.GITHUB_COM_TOKEN }}"

.gitignore

@@ -59,3 +59,9 @@ Thumbs.db
 
 # Backup files
 *.backup
+
+# Application data dir
+data/*
+
+# Application logs
+logs/*

.pre-commit-config.yaml

@@ -18,18 +18,18 @@ repos:
     hooks:
       - id: ruff-check
         name: Ruff Linter
-        entry: bash -c 'cd brain && poetry run ruff check --fix'
+        entry: bash -c 'make lint'
         language: system
         types: [python]
 
       - id: ruff-format
         name: Ruff Formatter
-        entry: bash -c 'cd brain && poetry run ruff format'
+        entry: bash -c 'make format'
         language: system
         types: [python]
 
       - id: system-pytest
         name: Pytest
-        entry: bash -c 'cd brain && poetry run pytest -n auto --dist=loadscope'
+        entry: bash -c 'make test'
         language: system
         always_run: true

Dockerfile

@@ -0,0 +1,115 @@
+# syntax=docker/dockerfile:1
+# check=skip=InvalidDefaultArgInFrom
+
+ARG PYTHON_VERSION
+ARG PYTHON_VERSION_SHORT
+ARG RUNNER
+# ===========================================
+# Stage 1: Builder
+# ===========================================
+FROM python:${PYTHON_VERSION}-slim-bookworm AS builder
+
+# Re-declare ARGs after FROM to make them available in this stage
+ARG RUNNER
+
+# STFU - No need - Write logs asap
+ENV DEBIAN_FRONTEND=noninteractive \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+# Install build dependencies (needs root)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install runner globally (needs root) - Save cache for future
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install $RUNNER
+
+# Set working directory for dependency installation
+WORKDIR /tmp
+
+# Copy dependency files
+COPY pyproject.toml poetry.lock* uv.lock* Makefile ./
+
+# Install dependencies as root (to avoid permission issues with system packages)
+RUN --mount=type=cache,target=/root/.cache/pip \
+    --mount=type=cache,target=/root/.cache/pypoetry \
+    --mount=type=cache,target=/root/.cache/uv \
+    if [ "$RUNNER" = "poetry" ]; then \
+        poetry config virtualenvs.create false && \
+        poetry install --only main --no-root; \
+    elif [ "$RUNNER" = "uv" ]; then \
+        uv pip install --system -r pyproject.toml; \
+    fi
+
+# ===========================================
+# Stage 2: Testing
+# ===========================================
+FROM builder AS test
+
+ARG RUNNER
+
+RUN --mount=type=cache,target=/root/.cache/pip \
+    --mount=type=cache,target=/root/.cache/pypoetry \
+    --mount=type=cache,target=/root/.cache/uv \
+    if [ "$RUNNER" = "poetry" ]; then \
+        poetry install --no-root; \
+    elif [ "$RUNNER" = "uv" ]; then \
+        uv pip install --system -e .[dev]; \
+    fi
+
+COPY alfred/ ./alfred
+COPY tests/ ./tests
+
+# ===========================================
+# Stage 3: Runtime
+# ===========================================
+FROM python:${PYTHON_VERSION}-slim-bookworm AS runtime
+
+ARG PYTHON_VERSION_SHORT
+
+ENV LLM_PROVIDER=deepseek \
+    MEMORY_STORAGE_DIR=/data/memory \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONPATH=/home/appuser/app \
+    PYTHONUNBUFFERED=1
+
+# Install runtime dependencies (needs root)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates \
+    && rm -rf /var/lib/apt/lists/* \
+    && apt-get clean
+
+# Create non-root user
+RUN useradd -m -u 1000 -s /bin/bash appuser
+
+# Create data directories (needs root for /data)
+RUN mkdir -p /data/memory /data/logs \
+    && chown -R appuser:appuser /data
+
+# Switch to non-root user
+USER appuser
+
+# Set working directory (owned by appuser)
+WORKDIR /home/appuser
+
+# Copy Python packages from builder stage
+COPY --from=builder /usr/local/lib/python${PYTHON_VERSION_SHORT}/site-packages /usr/local/lib/python${PYTHON_VERSION_SHORT}/site-packages
+COPY --from=builder /usr/local/bin /usr/local/bin
+
+# Copy application code (already owned by appuser)
+COPY --chown=appuser:appuser alfred/ ./alfred
+
+# Create volumes for persistent data
+VOLUME ["/data/memory", "/data/logs"]
+
+# Expose port
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD python -c "import requests; requests.get('http://localhost:8000/health', timeout=5).raise_for_status()" || exit 1
+
+# Run the application
+CMD ["python", "-m", "uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]

Makefile

@@ -1,25 +1,203 @@
-# Versioning
+.DEFAULT_GOAL := help
-check-branch-is-main:
-	@current_branch=$$(git rev-parse --abbrev-ref HEAD); \
-	if [ "$$current_branch" != "main" ]; then \
-	  echo "Error: not on the main branch" \
-	  exit 1; \
-	fi
 
-BUMP = cd brain && poetry run bump-my-version bump
+# --- Config ---
+export IMAGE_NAME			:= alfred_media_organizer
+export LIBRECHAT_VERSION 	:= v0.8.1
+export PYTHON_VERSION		:= 3.14.2
+export PYTHON_VERSION_SHORT	:= 3.14
+export RAG_VERSION 			:= v0.7.0
+export RUNNER				:= poetry
+export SERVICE_NAME			:= alfred
 
-.PHONY: help patch minor major
+# --- Commands ---
+CLI				:= python3 cli.py
+DOCKER_COMPOSE	:= docker compose
+DOCKER_BUILD	:= docker build \
+					--build-arg PYTHON_VERSION=$(PYTHON_VERSION) \
+					--build-arg PYTHON_VERSION_SHORT=$(PYTHON_VERSION_SHORT) \
+					--build-arg RUNNER=$(RUNNER)
+
+# --- Phony ---
+.PHONY: setup status check
+.PHONY: up down restart logs ps shell
+.PHONY: build build-test
+.PHONY: install update install-hooks
+.PHONY: test coverage lint format clean prune
+.PHONY: major minor patch
+.PHONY: help
+
+# --- Setup ---
+setup:
+	@echo "Initializing environment..."
+	@$(CLI) setup \
+		&&  echo "✓ Environment ready" \
+		|| (echo "✗ Setup failed" && exit 1)
+
+status:
+	@$(CLI) status
+
+check:
+	@$(CLI) check
+
+# --- Docker ---
+up: check
+	@echo "Starting containers..."
+	@$(DOCKER_COMPOSE) up -d --remove-orphans \
+		&& echo "✓ Containers started" \
+		|| (echo "✗ Failed to start containers" && exit 1)
+
+down:
+	@echo "Stopping containers..."
+	@$(DOCKER_COMPOSE) down \
+		&& echo "✓ Containers stopped" \
+		|| (echo "✗ Failed to stop containers" && exit 1)
+
+restart:
+	@echo "Restarting containers..."
+	@$(DOCKER_COMPOSE) restart \
+		&& echo "✓ Containers restarted" \
+		|| (echo "✗ Failed to restart containers" && exit 1)
+
+logs:
+	@echo "Following logs (Ctrl+C to exit)..."
+	@$(DOCKER_COMPOSE) logs -f
+
+ps:
+	@echo "Container status:"
+	@$(DOCKER_COMPOSE) ps
+
+shell:
+	@echo "Opening shell in $(SERVICE_NAME)..."
+	@$(DOCKER_COMPOSE) exec $(SERVICE_NAME) /bin/bash
+
+# --- Build ---
+build: check
+	@echo "Building image $(IMAGE_NAME):latest ..."
+	@$(DOCKER_BUILD) -t $(IMAGE_NAME):latest . \
+		&& echo "✓ Build complete" \
+		|| (echo "✗ Build failed" && exit 1)
+
+build-test: check
+	@echo "Building test image $(IMAGE_NAME):test..."
+	@$(DOCKER_BUILD) --target test -t $(IMAGE_NAME):test . \
+		&& echo "✓ Test image built" \
+		|| (echo "✗ Build failed" && exit 1)
+
+# --- Dependencies ---
+install:
+	@echo "Installing dependencies with $(RUNNER)..."
+	@$(RUNNER) install \
+		&& echo "✓ Dependencies installed" \
+		|| (echo "✗ Installation failed" && exit 1)
+
+update:
+	@echo "Updating dependencies with $(RUNNER)..."
+	@$(RUNNER) update \
+		&& echo "✓ Dependencies updated" \
+		|| (echo "✗ Update failed" && exit 1)
+
+install-hooks:
+	@echo "Installing pre-commit hooks..."
+	@$(RUNNER) run pre-commit install \
+		&& echo "✓ Hooks installed" \
+		|| (echo "✗ Hook installation failed" && exit 1)
+
+# --- Quality ---
+test:
+	@echo "Running tests..."
+	@$(RUNNER) run pytest \
+		&& echo "✓ Tests passed" \
+		|| (echo "✗ Tests failed" && exit 1)
+
+coverage:
+	@echo "Running tests with coverage..."
+	@$(RUNNER) run pytest --cov=. --cov-report=html --cov-report=term \
+		&& echo "✓ Coverage report generated" \
+		|| (echo "✗ Coverage failed" && exit 1)
+
+lint:
+	@echo "Linting code..."
+	@$(RUNNER) run ruff check --fix . \
+		&& echo "✓ Linting complete" \
+		|| (echo "✗ Linting failed" && exit 1)
+
+format:
+	@echo "Formatting code..."
+	@$(RUNNER) run ruff format . && $(RUNNER) run ruff check --fix . \
+		&& echo "✓ Code formatted" \
+		|| (echo "✗ Formatting failed" && exit 1)
+
+clean:
+	@echo "Cleaning build artifacts..."
+	@rm -rf .ruff_cache __pycache__ .pytest_cache htmlcov .coverage
+	@find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
+	@echo "✓ Cleanup complete"
+
+prune:
+	@echo "Pruning Docker system..."
+	@docker system prune -af \
+		&& echo "✓ Docker pruned" \
+		|| (echo "✗ Prune failed" && exit 1)
+
+# --- Versioning ---
+major minor patch: _check-main
+	@echo "Bumping $@ version..."
+	@$(RUNNER) run bump-my-version bump $@ \
+		&& echo "✓ Version bumped" \
+		|| (echo "✗ Version bump failed" && exit 1)
+
+	@echo "Pushing tags..."
+	@git push --tags \
+		&& echo "✓ Tags pushed" \
+		|| (echo "✗ Push failed" && exit 1)
+
+_ci-dump-config:
+	@echo "image_name=$(IMAGE_NAME)"
+	@echo "python_version=$(PYTHON_VERSION)"
+	@echo "python_version_short=$(PYTHON_VERSION_SHORT)"
+	@echo "runner=$(RUNNER)"
+	@echo "service_name=$(SERVICE_NAME)"
+
+_ci-run-tests:
+	@echo "Running tests in Docker..."
+	docker run --rm \
+		-e DEEPSEEK_API_KEY \
+		-e TMDB_API_KEY \
+		-e QBITTORRENT_URL \
+		$(IMAGE_NAME):test pytest
+	@echo "✓ Tests passed."
+
+_check-main:
+	@test "$$(git rev-parse --abbrev-ref HEAD)" = "main" \
+		|| (echo "✗ ERROR: Not on main branch" && exit 1)
+
+# --- Help ---
 help:
-		@echo "Versioning commands :"
+	@echo "Usage: make [target]"
-		@echo " make patch : Bump version 0.0.1 (bugfix)"
+	@echo ""
-		@echo " make minor : Bump version 0.1.0 (feature)"
+	@echo "Setup:"
-		@echo " make major : Bump version 1.0.0 (breaking change)"
+	@echo "  setup       Initialize .env"
-
+	@echo "  status      Show project status"
-patch:	check-branch-is-main
+	@echo ""
-		SKIP=all $(BUMP) patch
+	@echo "Docker:"
-
+	@echo "  up          Start containers"
-minor:	check-branch-is-main
+	@echo "  down        Stop containers"
-		SKIP=all $(BUMP) minor
+	@echo "  restart     Restart containers"
-
+	@echo "  logs        Follow logs"
-major:	check-branch-is-main
+	@echo "  ps          Container status"
-		SKIP=all $(BUMP) major
+	@echo "  shell       Shell into container"
+	@echo "  build       Build image"
+	@echo ""
+	@echo "Dev:"
+	@echo "  install     Install dependencies"
+	@echo "  update      Update dependencies"
+	@echo "  test        Run tests"
+	@echo "  coverage    Run tests with coverage"
+	@echo "  lint        Lint code"
+	@echo "  format      Format code"
+	@echo "  clean       Clean artifacts"
+	@echo ""
+	@echo "Release:"
+	@echo "  patch       Bump patch version"
+	@echo "  minor       Bump minor version"
+	@echo "  major       Bump major version"

alfred/agent/agent.py

@@ -5,7 +5,7 @@ import logging
 from collections.abc import AsyncGenerator
 from typing import Any
 
-from infrastructure.persistence import get_memory
+from alfred.infrastructure.persistence import get_memory
 
 from .config import settings
 from .prompts import PromptBuilder

alfred/agent/prompts.py

@@ -3,7 +3,7 @@
 import json
 from typing import Any
 
-from infrastructure.persistence import get_memory
+from alfred.infrastructure.persistence import get_memory
 
 from .registry import Tool
 

alfred/agent/tools/api.py

@@ -3,12 +3,12 @@
 import logging
 from typing import Any
 
-from application.movies import SearchMovieUseCase
+from alfred.application.movies import SearchMovieUseCase
-from application.torrents import AddTorrentUseCase, SearchTorrentsUseCase
+from alfred.application.torrents import AddTorrentUseCase, SearchTorrentsUseCase
-from infrastructure.api.knaben import knaben_client
+from alfred.infrastructure.api.knaben import knaben_client
-from infrastructure.api.qbittorrent import qbittorrent_client
+from alfred.infrastructure.api.qbittorrent import qbittorrent_client
-from infrastructure.api.tmdb import tmdb_client
+from alfred.infrastructure.api.tmdb import tmdb_client
-from infrastructure.persistence import get_memory
+from alfred.infrastructure.persistence import get_memory
 
 logger = logging.getLogger(__name__)
 

alfred/agent/tools/filesystem.py

@@ -2,8 +2,8 @@
 
 from typing import Any
 
-from application.filesystem import ListFolderUseCase, SetFolderPathUseCase
+from alfred.application.filesystem import ListFolderUseCase, SetFolderPathUseCase
-from infrastructure.filesystem import FileManager
+from alfred.infrastructure.filesystem import FileManager
 
 
 def set_path_for_folder(folder_name: str, path_value: str) -> dict[str, Any]:

alfred/agent/tools/language.py

@@ -3,7 +3,7 @@
 import logging
 from typing import Any
 
-from infrastructure.persistence import get_memory
+from alfred.infrastructure.persistence import get_memory
 
 logger = logging.getLogger(__name__)
 

alfred/app.py

@@ -12,12 +12,12 @@ from fastapi.responses import JSONResponse, StreamingResponse
 from fastapi.staticfiles import StaticFiles
 from pydantic import BaseModel, Field, validator
 
-from agent.agent import Agent
+from alfred.agent.agent import Agent
-from agent.config import settings
+from alfred.agent.config import settings
-from agent.llm.deepseek import DeepSeekClient
+from alfred.agent.llm.deepseek import DeepSeekClient
-from agent.llm.exceptions import LLMAPIError, LLMConfigurationError
+from alfred.agent.llm.exceptions import LLMAPIError, LLMConfigurationError
-from agent.llm.ollama import OllamaClient
+from alfred.agent.llm.ollama import OllamaClient
-from infrastructure.persistence import get_memory, init_memory
+from alfred.infrastructure.persistence import get_memory, init_memory
 
 logging.basicConfig(
     level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
@@ -41,7 +41,6 @@ else:
     )
 
 # Initialize memory context at startup
-# Use /data/memory in Docker, fallback to memory_data for local dev
 storage_dir = os.getenv("MEMORY_STORAGE_DIR", "memory_data")
 init_memory(storage_dir=storage_dir)
 logger.info(f"Memory context initialized (storage: {storage_dir})")

alfred/application/filesystem/list_folder.py

@@ -2,7 +2,7 @@
 
 import logging
 
-from infrastructure.filesystem import FileManager
+from alfred.infrastructure.filesystem import FileManager
 
 from .dto import ListFolderResponse
 

alfred/application/filesystem/set_folder_path.py

@@ -2,7 +2,7 @@
 
 import logging
 
-from infrastructure.filesystem import FileManager
+from alfred.infrastructure.filesystem import FileManager
 
 from .dto import SetFolderPathResponse
 

alfred/application/movies/search_movie.py

@@ -2,7 +2,7 @@
 
 import logging
 
-from infrastructure.api.tmdb import (
+from alfred.infrastructure.api.tmdb import (
     TMDBAPIError,
     TMDBClient,
     TMDBConfigurationError,

alfred/application/torrents/add_torrent.py

@@ -2,7 +2,7 @@
 
 import logging
 
-from infrastructure.api.qbittorrent import (
+from alfred.infrastructure.api.qbittorrent import (
     QBittorrentAPIError,
     QBittorrentAuthError,
     QBittorrentClient,

alfred/application/torrents/search_torrents.py

@@ -2,7 +2,11 @@
 
 import logging
 
-from infrastructure.api.knaben import KnabenAPIError, KnabenClient, KnabenNotFoundError
+from alfred.infrastructure.api.knaben import (
+    KnabenAPIError,
+    KnabenClient,
+    KnabenNotFoundError,
+)
 
 from .dto import SearchTorrentsResponse
 

alfred/infrastructure/api/knaben/client.py

@@ -6,7 +6,7 @@ from typing import Any
 import requests
 from requests.exceptions import HTTPError, RequestException, Timeout
 
-from agent.config import Settings, settings
+from alfred.agent.config import Settings, settings
 
 from .dto import TorrentResult
 from .exceptions import KnabenAPIError, KnabenNotFoundError

alfred/infrastructure/api/qbittorrent/client.py

@@ -6,7 +6,7 @@ from typing import Any
 import requests
 from requests.exceptions import HTTPError, RequestException, Timeout
 
-from agent.config import Settings, settings
+from alfred.agent.config import Settings, settings
 
 from .dto import TorrentInfo
 from .exceptions import QBittorrentAPIError, QBittorrentAuthError

alfred/infrastructure/api/tmdb/client.py

@@ -6,7 +6,7 @@ from typing import Any
 import requests
 from requests.exceptions import HTTPError, RequestException, Timeout
 
-from agent.config import Settings, settings
+from alfred.agent.config import Settings, settings
 
 from .dto import MediaResult
 from .exceptions import (

alfred/infrastructure/filesystem/file_manager.py

@@ -7,7 +7,7 @@ from enum import Enum
 from pathlib import Path
 from typing import Any
 
-from infrastructure.persistence import get_memory
+from alfred.infrastructure.persistence import get_memory
 
 from .exceptions import PathTraversalError
 

alfred/infrastructure/filesystem/organizer.py

@@ -3,9 +3,9 @@
 import logging
 from pathlib import Path
 
-from domain.movies.entities import Movie
+from alfred.domain.movies.entities import Movie
-from domain.tv_shows.entities import Episode, Season, TVShow
+from alfred.domain.tv_shows.entities import Episode, Season, TVShow
-from domain.tv_shows.value_objects import SeasonNumber
+from alfred.domain.tv_shows.value_objects import SeasonNumber
 
 logger = logging.getLogger(__name__)
 

alfred/infrastructure/persistence/context.py

@@ -6,7 +6,7 @@ without passing it explicitly through all function calls.
 
 Usage:
     # At application startup
-    from infrastructure.persistence import init_memory, get_memory
+    from alfred.infrastructure.persistence import init_memory, get_memory
 
     init_memory("memory_data")
 

alfred/infrastructure/persistence/json/movie_repository.py

@@ -4,11 +4,11 @@ import logging
 from datetime import datetime
 from typing import Any
 
-from domain.movies.entities import Movie
+from alfred.domain.movies.entities import Movie
-from domain.movies.repositories import MovieRepository
+from alfred.domain.movies.repositories import MovieRepository
-from domain.movies.value_objects import MovieTitle, Quality, ReleaseYear
+from alfred.domain.movies.value_objects import MovieTitle, Quality, ReleaseYear
-from domain.shared.value_objects import FilePath, FileSize, ImdbId
+from alfred.domain.shared.value_objects import FilePath, FileSize, ImdbId
-from infrastructure.persistence import get_memory
+from alfred.infrastructure.persistence import get_memory
 
 logger = logging.getLogger(__name__)
 

alfred/infrastructure/persistence/json/subtitle_repository.py

@@ -3,11 +3,11 @@
 import logging
 from typing import Any
 
-from domain.shared.value_objects import FilePath, ImdbId
+from alfred.domain.shared.value_objects import FilePath, ImdbId
-from domain.subtitles.entities import Subtitle
+from alfred.domain.subtitles.entities import Subtitle
-from domain.subtitles.repositories import SubtitleRepository
+from alfred.domain.subtitles.repositories import SubtitleRepository
-from domain.subtitles.value_objects import Language, SubtitleFormat, TimingOffset
+from alfred.domain.subtitles.value_objects import Language, SubtitleFormat, TimingOffset
-from infrastructure.persistence import get_memory
+from alfred.infrastructure.persistence import get_memory
 
 logger = logging.getLogger(__name__)
 

alfred/infrastructure/persistence/json/tvshow_repository.py

@@ -4,11 +4,11 @@ import logging
 from datetime import datetime
 from typing import Any
 
-from domain.shared.value_objects import ImdbId
+from alfred.domain.shared.value_objects import ImdbId
-from domain.tv_shows.entities import TVShow
+from alfred.domain.tv_shows.entities import TVShow
-from domain.tv_shows.repositories import TVShowRepository
+from alfred.domain.tv_shows.repositories import TVShowRepository
-from domain.tv_shows.value_objects import ShowStatus
+from alfred.domain.tv_shows.value_objects import ShowStatus
-from infrastructure.persistence import get_memory
+from alfred.infrastructure.persistence import get_memory
 
 logger = logging.getLogger(__name__)
 

brain/Dockerfile

@@ -1,91 +0,0 @@
-# Dockerfile for Agent Media
-# Multi-stage build for smaller image size
-
-# ===========================================
-# Stage 1: Builder
-# ===========================================
-FROM python:3.12.7-slim as builder
-
-# STFU (please)
-ENV DEBIAN_FRONTEND=noninteractive
-
-# Install build dependencies (needs root)
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    build-essential \
-    && rm -rf /var/lib/apt/lists/*
-
-# Install Poetry globally (needs root)
-RUN pip install --no-cache-dir poetry
-
-# Copy dependency files (as root for now)
-COPY pyproject.toml poetry.lock* /tmp/
-
-# Install dependencies as root (to avoid permission issues with system packages)
-WORKDIR /tmp
-RUN poetry config virtualenvs.create false \
-    && poetry install --only main --no-root --no-cache
-
-# Create non-root user
-RUN useradd -m -u 1000 -s /bin/bash appuser
-
-# Switch to non-root user
-USER appuser
-
-# Set working directory (owned by appuser)
-WORKDIR /home/appuser/app
-
-# ===========================================
-# Stage 2: Runtime
-# ===========================================
-FROM python:3.12.7-slim as runtime
-
-# Install runtime dependencies (needs root)
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    curl \
-    ca-certificates \
-    && rm -rf /var/lib/apt/lists/* \
-    && apt-get clean
-
-# Create non-root user
-RUN useradd -m -u 1000 -s /bin/bash appuser
-
-# Create data directories (needs root for /data)
-RUN mkdir -p /data/memory /data/logs \
-    && chown -R appuser:appuser /data
-
-# Switch to non-root user
-USER appuser
-
-# Set working directory (owned by appuser)
-WORKDIR /home/appuser/app
-
-# Copy Python packages from builder stage
-COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
-COPY --from=builder /usr/local/bin /usr/local/bin
-
-# Copy application code (already owned by appuser)
-COPY --chown=appuser:appuser agent/ ./agent/
-COPY --chown=appuser:appuser application/ ./application/
-COPY --chown=appuser:appuser domain/ ./domain/
-COPY --chown=appuser:appuser infrastructure/ ./infrastructure/
-COPY --chown=appuser:appuser app.py .
-
-# Create volumes for persistent data
-VOLUME ["/data/memory", "/data/logs"]
-
-# Expose port
-EXPOSE 8000
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
-    CMD curl -f http://localhost:8000/health || exit 1
-
-# Environment variables (can be overridden)
-ENV PYTHONUNBUFFERED=1 \
-    PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONPATH=/home/appuser/app \
-    LLM_PROVIDER=deepseek \
-    MEMORY_STORAGE_DIR=/data/memory
-
-# Run the application
-CMD ["python", "-m", "uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]

cli.py

@@ -0,0 +1,231 @@
+#!/usr/bin/env python3
+import os
+import secrets
+import shutil
+import subprocess
+import sys
+from datetime import datetime
+from enum import StrEnum
+from pathlib import Path
+from typing import NoReturn
+
+REQUIRED_VARS = ["DEEPSEEK_API_KEY", "TMDB_API_KEY", "QBITTORRENT_URL"]
+
+# Size in bytes
+KEYS_TO_GENERATE = {
+    "JWT_SECRET": 32,
+    "JWT_REFRESH_SECRET": 32,
+    "CREDS_KEY": 32,
+    "CREDS_IV": 16,
+}
+
+
+class Style(StrEnum):
+    """ANSI codes for styling output.
+    Usage: f"{Style.RED}Error{Style.RESET}"
+    """
+
+    RESET = "\033[0m"
+    BOLD = "\033[1m"
+    RED = "\033[31m"
+    GREEN = "\033[32m"
+    YELLOW = "\033[33m"
+    CYAN = "\033[36m"
+    DIM = "\033[2m"
+
+
+# Only for terminals and if not specified otherwise
+USE_COLORS = sys.stdout.isatty() and "NO_COLOR" not in os.environ
+
+
+def styled(text: str, color_code: str) -> str:
+    """Apply color only if supported by the terminal."""
+    if USE_COLORS:
+        return f"{color_code}{text}{Style.RESET}"
+    return text
+
+
+def log(msg: str, color: str | None = None, prefix="") -> None:
+    """Print a formatted message."""
+    formatted_msg = styled(msg, color) if color else msg
+    print(f"{prefix}{formatted_msg}")
+
+
+def error_exit(msg: str) -> NoReturn:
+    """Print an error message in red and exit."""
+    log(f"❌ {msg}", Style.RED)
+    sys.exit(1)
+
+
+def is_docker_running() -> bool:
+    """ "Check if Docker is available and responsive."""
+    if shutil.which("docker") is None:
+        error_exit("Docker is not installed.")
+
+    result = subprocess.run(
+        ["docker", "info"],
+        # Redirect stdout/stderr to keep output clean on success
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+        # Prevent exception being raised
+        check=False,
+    )
+    return result.returncode == 0
+
+
+def parse_env(content: str) -> dict[str, str]:
+    """Parses existing keys and values into a dict (ignoring comments)."""
+    env_vars = {}
+    for raw_line in content.splitlines():
+        line = raw_line.strip()
+        if line and not line.startswith("#") and "=" in line:
+            key, value = line.split("=", 1)
+            env_vars[key.strip()] = value.strip()
+
+    return env_vars
+
+
+def dump_env(content: str, data: dict[str, str]) -> str:
+    new_content: list[str] = []
+    processed_keys = set()
+
+    for raw_line in content.splitlines():
+        line = raw_line.strip()
+        # Fast line (empty, comment or not an assignation)
+        if len(line) == 0 or line.startswith("#") or "=" not in line:
+            new_content.append(raw_line)
+            continue
+
+        # Slow line (inline comment to be kept)
+        key_chunk, value_chunk = raw_line.split("=", 1)
+        key = key_chunk.strip()
+
+        # Not in the update list
+        if key not in data:
+            new_content.append(raw_line)
+            continue
+
+        processed_keys.add(key)
+        new_value = data[key]
+
+        if " #" not in value_chunk:
+            new_line = f"{key_chunk}={new_value}"
+        else:
+            _, comment = value_chunk.split(" #", 1)
+            new_line = f"{key_chunk}={new_value} #{comment}"
+
+        new_content.append(new_line)
+
+    for key, value in data.items():
+        if key not in processed_keys:
+            new_content.append(f"{key}={value}")
+
+    return "\n".join(new_content) + "\n"
+
+
+def ensure_env() -> None:
+    """Manage .env lifecycle: creation, secret generation, prompts."""
+    env_path = Path(".env")
+    env_example_path = Path(".env.example")
+    updated: bool = False
+
+    # Read .env if exists
+    if env_path.exists():
+        content: str = env_path.read_text(encoding="utf-8")
+    else:
+        content: str = env_example_path.read_text(encoding="utf-8")
+
+    existing_vars: dict[str, str] = parse_env(content)
+
+    # Generate missing secrets
+    for key, length in KEYS_TO_GENERATE.items():
+        if key not in existing_vars or not existing_vars[key]:
+            log(f"Generating {key}...", Style.GREEN, prefix="   ")
+            existing_vars[key] = secrets.token_hex(length)
+            updated = True
+            log("Done", Style.GREEN, prefix="   ")
+
+    # Prompt for missing mandatory keys
+    color = Style.YELLOW if USE_COLORS else ""
+    reset = Style.RESET if USE_COLORS else ""
+    for key in REQUIRED_VARS:
+        if key not in existing_vars or not existing_vars[key]:
+            try:
+                existing_vars[key] = input(
+                    f"   {color}Enter value for {key}: {reset}"
+                ).strip()
+                updated = True
+            except KeyboardInterrupt:
+                print()
+                error_exit("Aborted by user.")
+
+    # Write to disk
+    if updated:
+        # But backup original first
+        if env_path.exists():
+            timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+            backup_path = Path(f"{env_path}.{timestamp}.bak")
+            shutil.copy(env_path, backup_path)
+            log(f"Backup created: {backup_path}", Style.DIM)
+
+        new_content = dump_env(content, existing_vars)
+        env_path.write_text(new_content, encoding="utf-8")
+        log(".env updated successfully.", Style.GREEN)
+    else:
+        log("Configuration is up to date.", Style.GREEN)
+
+
+def setup() -> None:
+    """Orchestrate initialization."""
+    is_docker_running()
+    ensure_env()
+
+
+def status() -> None:
+    """Display simple dashboard."""
+    # Hardcoded bold style for title if colors are enabled
+    title_style = Style.BOLD if USE_COLORS else ""
+    reset_style = Style.RESET if USE_COLORS else ""
+
+    print(f"\n{title_style}ALFRED STATUS{reset_style}")
+    print(f"{title_style}==============={reset_style}\n")
+
+    # Docker Check
+    if is_docker_running():
+        print(f"   Docker:  {styled('✓ running', Style.GREEN)}")
+    else:
+        print(f"   Docker:  {styled('✗ stopped', Style.RED)}")
+
+    # Env Check
+    if Path(".env").exists():
+        print(f"   .env:    {styled('✓ present', Style.GREEN)}")
+    else:
+        print(f"   .env:    {styled('✗ missing', Style.RED)}")
+
+    print("")
+
+
+def check() -> None:
+    """Silent check for prerequisites (used by 'make up')."""
+    setup()
+
+
+def main() -> None:
+    if len(sys.argv) < 2:
+        print("Usage: python cli.py [setup|check|status]")
+        sys.exit(1)
+
+    cmd = sys.argv[1]
+
+    if cmd == "setup":
+        setup()
+    elif cmd == "check":
+        check()
+    elif cmd == "status":
+        status()
+    else:
+        error_exit(f"Unknown command: {cmd}")
+
+
+if __name__ == "__main__":
+    main()

docker-compose.yaml

@@ -0,0 +1,100 @@
+services:
+  alfred:
+    container_name: alfred-core
+    build:
+      context: .
+      args:
+        PYTHON_VERSION: ${PYTHON_VERSION}
+        PYTHON_VERSION_SHORT: ${PYTHON_VERSION_SHORT}
+        RUNNER: ${RUNNER}
+    depends_on:
+    - librechat
+    restart: unless-stopped
+    env_file:
+      - .env
+    environment:
+      # LLM Configuration
+      LLM_PROVIDER: ${LLM_PROVIDER:-deepseek}
+      DEEPSEEK_API_KEY: ${DEEPSEEK_API_KEY:-}
+
+      # Memory storage
+      MEMORY_STORAGE_DIR: /data/memory
+
+      # External services
+      TMDB_API_KEY: ${TMDB_API_KEY:-}
+      QBITTORRENT_URL: ${QBITTORRENT_URL:-}
+      QBITTORRENT_USERNAME: ${QBITTORRENT_USERNAME:-}
+      QBITTORRENT_PASSWORD: ${QBITTORRENT_PASSWORD:-}
+    volumes:
+      - ./data/memory:/data/memory
+      - ./logs:/data/logs
+    # TODO: Development: mount code for hot reload (comment out in production)
+    # - ./alfred:/app/alfred
+
+  librechat:
+    container_name: alfred-librechat
+    image: ghcr.io/danny-avila/librechat:${LIBRECHAT_VERSION}
+    depends_on:
+      - mongodb
+      - meilisearch
+      - rag_api
+    restart: unless-stopped
+    env_file:
+      - .env
+    environment:
+      - HOST=0.0.0.0
+      - MONGO_URI=mongodb://mongodb:27017/LibreChat
+      - MEILI_HOST=http://meilisearch:7700
+      - RAG_PORT=${RAG_PORT:-8000}
+      - RAG_API_URL=http://rag_api:${RAG_PORT:-8000}
+    ports:
+      - "${LIBRECHAT_PORT:-3080}:3080"
+    volumes:
+      - ./data/librechat/images:/app/client/public/images
+      - ./data/librechat/uploads:/app/client/uploads
+      - ./logs:/app/api/logs
+      # Mount custom endpoint
+      - ./librechat/manifests:/app/manifests:ro
+      - ./librechat/librechat.yaml:/app/librechat.yaml:ro
+
+  mongodb:
+    container_name: alfred-mongodb
+    image: mongo:latest
+    restart: unless-stopped
+    volumes:
+      - ./data/mongo:/data/db
+    command: mongod --noauth
+
+  meilisearch:
+    container_name: alfred-meilisearch
+    image: getmeili/meilisearch:v1.12.3
+    restart: unless-stopped
+    environment:
+      - MEILI_NO_ANALYTICS=true
+    volumes:
+      - ./data/meili:/meili_data
+    #profiles: ["meili", "full"]
+
+  rag_api:
+    container_name: alfred-rag
+    image: ghcr.io/danny-avila/librechat-rag-api-dev-lite:${RAG_VERSION}
+    restart: unless-stopped
+    environment:
+      - RAG_PORT=${RAG_PORT:-8000}
+    ports:
+      - "${RAG_PORT:-8000}:${RAG_PORT:-8000}"
+    #profiles: ["rag", "full"]
+
+  vectordb:
+    container_name: alfred-vectordb
+    image: pgvector/pgvector:0.8.0-pg16-bookworm
+    restart: unless-stopped
+    environment:
+      - POSTGRES_DB=${VECTOR_DB_NAME:-vectordb}
+      - POSTGRES_USER=${VECTOR_DB_USER:-postgres}
+      - POSTGRES_PASSWORD=${VECTOR_DB_PASSWORD:-postgres}
+    ports:
+      - "${VECTOR_DB_PORT:-5432}:5432"
+    volumes:
+      - ./data/vectordb:/var/lib/postgresql/data
+    #profiles: ["rag", "full"]

docker-compose.yml

@@ -1,204 +0,0 @@
-version: "3.4"
-
-services:
-  # Da brain
-  agent-brain:
-    build:
-      context: ./brain
-      dockerfile: Dockerfile
-    container_name: agent-brain
-    restart: unless-stopped
-    env_file: .env
-    ports:
-      - "8000:8000"
-    volumes:
-      # Persistent data volumes (outside container /app)
-      - agent-memory:/data/memory
-      - agent-logs:/data/logs
-      # Development: mount code for hot reload (comment out in production)
-      # - ./brain:/app
-    environment:
-      # LLM Configuration
-      LLM_PROVIDER: ${LLM_PROVIDER:-deepseek}
-      DEEPSEEK_API_KEY: ${DEEPSEEK_API_KEY:-}
-
-      # Memory storage
-      MEMORY_STORAGE_DIR: /data/memory
-
-      # External services
-      TMDB_API_KEY: ${TMDB_API_KEY:-}
-      QBITTORRENT_URL: ${QBITTORRENT_URL:-}
-      QBITTORRENT_USERNAME: ${QBITTORRENT_USERNAME:-}
-      QBITTORRENT_PASSWORD: ${QBITTORRENT_PASSWORD:-}
-    networks:
-      - agent-network
-
-  # Da face (LibreChat)
-  librechat:
-    image: ghcr.io/danny-avila/librechat-dev:latest
-    container_name: librechat-frontend
-    restart: unless-stopped
-    ports:
-      - "3080:3080"
-    depends_on:
-      - mongodb
-      - meilisearch
-      - rag_api
-      - agent-brain
-    env_file: .env
-    environment:
-      # MongoDB connection (no auth, matching LibreChat default)
-      MONGO_URI: mongodb://mongodb:27017/LibreChat
-      
-      # App configuration
-      HOST: 0.0.0.0
-      PORT: 3080
-      
-      # Security
-      JWT_SECRET: ${JWT_SECRET:-your-super-secret-jwt-key-change-this-in-production}
-      JWT_REFRESH_SECRET: ${JWT_REFRESH_SECRET:-your-super-secret-refresh-key-change-this-too}
-      CREDS_KEY: ${CREDS_KEY:-your-32-character-secret-key-here}
-      CREDS_IV: ${CREDS_IV:-your-16-character-iv-here}
-      
-      # Session
-      SESSION_EXPIRY: ${SESSION_EXPIRY:-1000 * 60 * 15}
-      REFRESH_TOKEN_EXPIRY: ${REFRESH_TOKEN_EXPIRY:-1000 * 60 * 60 * 24 * 7}
-      
-      # Domain
-      DOMAIN_CLIENT: ${DOMAIN_CLIENT:-http://localhost:3080}
-      DOMAIN_SERVER: ${DOMAIN_SERVER:-http://localhost:3080}
-
-      # Meilisearch
-      MEILI_HOST: http://meilisearch:7700
-      MEILI_MASTER_KEY: ${MEILI_MASTER_KEY:-DrhYf7zENyR6AlUCKmnz0eYASOQdl6zxH7s7MKFSfFU}
-
-      # RAG API
-      RAG_API_URL: http://rag_api:8000
-
-      # Endpoints
-      ENDPOINTS: custom
-
-      # Custom endpoint pointing to agent-brain
-      CUSTOM_API_KEY: ${AGENT_BRAIN_API_KEY:-agent-brain-secret-key}
-
-      # Debug (optional)
-      DEBUG_LOGGING: ${DEBUG_LOGGING:-false}
-      DEBUG_CONSOLE: ${DEBUG_CONSOLE:-false}
-    volumes:
-      - ./librechat/librechat.yaml:/app/librechat.yaml:ro
-      - librechat-images:/app/client/public/images
-      - librechat-logs:/app/api/logs
-    networks:
-      - agent-network
-
-  # MongoDB for LibreChat
-  mongodb:
-    image: mongo:latest
-    container_name: librechat-mongodb
-    restart: unless-stopped
-    volumes:
-      - mongodb-data:/data/db
-    command: mongod --noauth
-    ports:
-      - "27017:27017"
-    networks:
-      - agent-network
-
-  # Meilisearch - Search engine for LibreChat
-  meilisearch:
-    image: getmeili/meilisearch:v1.11.3
-    container_name: librechat-meilisearch
-    restart: unless-stopped
-    volumes:
-      - meilisearch-data:/meili_data
-    environment:
-      MEILI_HOST: http://meilisearch:7700
-      MEILI_HTTP_ADDR: meilisearch:7700
-      MEILI_MASTER_KEY: ${MEILI_MASTER_KEY:-DrhYf7zENyR6AlUCKmnz0eYASOQdl6zxH7s7MKFSfFU}
-    ports:
-      - "7700:7700"
-    networks:
-      - agent-network
-
-  # PostgreSQL with pgvector for RAG API
-  pgvector:
-    image: ankane/pgvector:latest
-    container_name: librechat-pgvector
-    restart: unless-stopped
-    environment:
-      POSTGRES_DB: ${POSTGRES_DB:-librechat_rag}
-      POSTGRES_USER: ${POSTGRES_USER:-postgres}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
-    volumes:
-      - pgvector-data:/var/lib/postgresql/data
-    ports:
-      - "5432:5432"
-    networks:
-      - agent-network
-
-  # RAG API - Vector database for LibreChat
-  rag_api:
-    image: ghcr.io/danny-avila/librechat-rag-api-dev-lite:latest
-    container_name: librechat-rag-api
-    restart: unless-stopped
-    depends_on:
-      - pgvector
-    environment:
-      PORT: 8000
-      HOST: 0.0.0.0
-      # PostgreSQL connection (multiple variable names for compatibility)
-      DB_HOST: pgvector
-      DB_PORT: 5432
-      DB_NAME: ${POSTGRES_DB:-librechat_rag}
-      DB_USER: ${POSTGRES_USER:-postgres}
-      DB_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
-      POSTGRES_DB: ${POSTGRES_DB:-librechat_rag}
-      POSTGRES_USER: ${POSTGRES_USER:-postgres}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
-      # RAG configuration
-      COLLECTION_NAME: ${RAG_COLLECTION_NAME:-testcollection}
-      EMBEDDINGS_PROVIDER: ${RAG_EMBEDDINGS_PROVIDER:-openai}
-      EMBEDDINGS_MODEL: ${RAG_EMBEDDINGS_MODEL:-text-embedding-3-small}
-      OPENAI_API_KEY: ${OPENAI_API_KEY:-}
-      RAG_UPLOAD_DIR: /app/uploads
-    volumes:
-      - rag-uploads:/app/uploads
-    ports:
-      - "8001:8000"
-    networks:
-      - agent-network
-
-# Named volumes for persistent data
-volumes:
-  # MongoDB data
-  mongodb-data:
-    driver: local
-
-  # Meilisearch data
-  meilisearch-data:
-    driver: local
-
-  # PostgreSQL pgvector data
-  pgvector-data:
-    driver: local
-
-  # RAG API uploads
-  rag-uploads:
-    driver: local
-
-  # LibreChat data
-  librechat-images:
-    driver: local
-  librechat-logs:
-    driver: local
-
-  # Agent Brain data
-  agent-memory:
-    driver: local
-  agent-logs:
-    driver: local
-
-# Network for inter-service communication
-networks:
-  agent-network:
-    driver: bridge

generate-keys.sh

@@ -1,27 +0,0 @@
-#!/bin/bash
-
-# Script to generate secure keys for LibreChat
-# Run this script to generate random secure keys for your .env file
-
-echo "==================================="
-echo "LibreChat Security Keys Generator"
-echo "==================================="
-echo ""
-
-echo "# MongoDB Password"
-echo "MONGO_PASSWORD=$(openssl rand -base64 24)"
-echo ""
-
-echo "# JWT Secrets"
-echo "JWT_SECRET=$(openssl rand -base64 32)"
-echo "JWT_REFRESH_SECRET=$(openssl rand -base64 32)"
-echo ""
-
-echo "# Credentials Encryption Keys"
-echo "CREDS_KEY=$(openssl rand -hex 16)"
-echo "CREDS_IV=$(openssl rand -hex 8)"
-echo ""
-
-echo "==================================="
-echo "Copy these values to your .env file"
-echo "==================================="

librechat/librechat.yaml

@@ -22,7 +22,7 @@ endpoints:
           manifest:
             schema:
               type: openapi
-              url: "http://agent-brain:8000/manifests/find_media_imdb_id.json"
+              url: "http://alfred:8000/manifests/find_media_imdb_id.json"
             auth:
               type: none
 
@@ -32,7 +32,7 @@ endpoints:
           manifest:
             schema:
               type: openapi
-              url: "http://agent-brain:8000/manifests/find_torrent.json"
+              url: "http://alfred:8000/manifests/find_torrent.json"
             auth:
               type: none
 
@@ -42,7 +42,7 @@ endpoints:
           manifest:
             schema:
               type: openapi
-              url: "http://agent-brain:8000/manifests/add_torrent_by_index.json"
+              url: "http://alfred:8000/manifests/add_torrent_by_index.json"
             auth:
               type: none
 
@@ -52,7 +52,7 @@ endpoints:
           manifest:
             schema:
               type: openapi
-              url: "http://agent-brain:8000/manifests/set_language.json"
+              url: "http://alfred:8000/manifests/set_language.json"
             auth:
               type: none
 
@@ -60,7 +60,7 @@ endpoints:
     # Backend Local Agent
     - name: "Local Agent"
       apiKey: "dummy_key"
-      baseURL: "http://agent-brain:8000/v1"
+      baseURL: "http://alfred:8000/v1"
       models:
         default: ["local-deepseek-agent"]
         fetch: false
@@ -75,7 +75,7 @@ endpoints:
           manifest:
             schema:
               type: openapi
-              url: "http://agent-brain:8000/manifests/find_media_imdb_id.json"
+              url: "http://alfred:8000/manifests/find_media_imdb_id.json"
             auth:
               type: none
 
@@ -85,7 +85,7 @@ endpoints:
           manifest:
             schema:
               type: openapi
-              url: "http://agent-brain:8000/manifests/find_torrent.json"
+              url: "http://alfred:8000/manifests/find_torrent.json"
             auth:
               type: none
 
@@ -95,7 +95,7 @@ endpoints:
           manifest:
             schema:
               type: openapi
-              url: "http://agent-brain:8000/manifests/add_torrent_by_index.json"
+              url: "http://alfred:8000/manifests/add_torrent_by_index.json"
             auth:
               type: none
 
@@ -105,6 +105,6 @@ endpoints:
           manifest:
             schema:
               type: openapi
-              url: "http://agent-brain:8000/manifests/set_language.json"
+              url: "http://alfred:8000/manifests/set_language.json"
             auth:
               type: none

poetry.lock

@@ -35,7 +35,6 @@ files = [
 
 [package.dependencies]
 idna = ">=2.8"
-typing_extensions = {version = ">=4.5", markers = "python_version < \"3.13\""}
 
 [package.extras]
 trio = ["trio (>=0.31.0)", "trio (>=0.32.0)"]
@@ -373,25 +372,25 @@ testing = ["hatch", "pre-commit", "pytest", "tox"]
 
 [[package]]
 name = "fastapi"
-version = "0.121.3"
+version = "0.127.1"
 description = "FastAPI framework, high performance, easy to learn, fast to code, ready for production"
 optional = false
-python-versions = ">=3.8"
+python-versions = ">=3.9"
 files = [
-    {file = "fastapi-0.121.3-py3-none-any.whl", hash = "sha256:0c78fc87587fcd910ca1bbf5bc8ba37b80e119b388a7206b39f0ecc95ebf53e9"},
+    {file = "fastapi-0.127.1-py3-none-any.whl", hash = "sha256:31d670a4f9373cc6d7994420f98e4dc46ea693145207abc39696746c83a44430"},
-    {file = "fastapi-0.121.3.tar.gz", hash = "sha256:0055bc24fe53e56a40e9e0ad1ae2baa81622c406e548e501e717634e2dfbc40b"},
+    {file = "fastapi-0.127.1.tar.gz", hash = "sha256:946a87ee5d931883b562b6bada787d6c8178becee2683cb3f9b980d593206359"},
 ]
 
 [package.dependencies]
 annotated-doc = ">=0.0.2"
-pydantic = ">=1.7.4,<1.8 || >1.8,<1.8.1 || >1.8.1,<2.0.0 || >2.0.0,<2.0.1 || >2.0.1,<2.1.0 || >2.1.0,<3.0.0"
+pydantic = ">=2.7.0"
 starlette = ">=0.40.0,<0.51.0"
 typing-extensions = ">=4.8.0"
 
 [package.extras]
 all = ["email-validator (>=2.0.0)", "fastapi-cli[standard] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "itsdangerous (>=1.1.0)", "jinja2 (>=3.1.5)", "orjson (>=3.2.1)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "pyyaml (>=5.3.1)", "ujson (>=4.0.1,!=4.0.2,!=4.1.0,!=4.2.0,!=4.3.0,!=5.0.0,!=5.1.0)", "uvicorn[standard] (>=0.12.0)"]
-standard = ["email-validator (>=2.0.0)", "fastapi-cli[standard] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "jinja2 (>=3.1.5)", "python-multipart (>=0.0.18)", "uvicorn[standard] (>=0.12.0)"]
+standard = ["email-validator (>=2.0.0)", "fastapi-cli[standard] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "jinja2 (>=3.1.5)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "uvicorn[standard] (>=0.12.0)"]
-standard-no-fastapi-cloud-cli = ["email-validator (>=2.0.0)", "fastapi-cli[standard-no-fastapi-cloud-cli] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "jinja2 (>=3.1.5)", "python-multipart (>=0.0.18)", "uvicorn[standard] (>=0.12.0)"]
+standard-no-fastapi-cloud-cli = ["email-validator (>=2.0.0)", "fastapi-cli[standard-no-fastapi-cloud-cli] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "jinja2 (>=3.1.5)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "uvicorn[standard] (>=0.12.0)"]
 
 [[package]]
 name = "filelock"
@@ -535,13 +534,13 @@ files = [
 
 [[package]]
 name = "nodeenv"
-version = "1.9.1"
+version = "1.10.0"
 description = "Node.js virtual environment builder"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7"
 files = [
-    {file = "nodeenv-1.9.1-py2.py3-none-any.whl", hash = "sha256:ba11c9782d29c27c70ffbdda2d7415098754709be8a7056d79a737cd901155c9"},
+    {file = "nodeenv-1.10.0-py2.py3-none-any.whl", hash = "sha256:5bb13e3eed2923615535339b3c620e76779af4cb4c6a90deccc9e36b274d3827"},
-    {file = "nodeenv-1.9.1.tar.gz", hash = "sha256:6ec12890a2dab7946721edbfbcd91f3319c6ccc9aec47be7c7e6b7011ee6645f"},
+    {file = "nodeenv-1.10.0.tar.gz", hash = "sha256:996c191ad80897d076bdfba80a41994c2b47c68e224c542b48feba42ba00f8bb"},
 ]
 
 [[package]]
@@ -1037,13 +1036,13 @@ jupyter = ["ipywidgets (>=7.5.1,<9)"]
 
 [[package]]
 name = "rich-click"
-version = "1.9.4"
+version = "1.9.5"
 description = "Format click help output nicely with rich"
 optional = false
 python-versions = ">=3.8"
 files = [
-    {file = "rich_click-1.9.4-py3-none-any.whl", hash = "sha256:d70f39938bcecaf5543e8750828cbea94ef51853f7d0e174cda1e10543767389"},
+    {file = "rich_click-1.9.5-py3-none-any.whl", hash = "sha256:9b195721a773b1acf0e16ff9ec68cef1e7d237e53471e6e3f7ade462f86c403a"},
-    {file = "rich_click-1.9.4.tar.gz", hash = "sha256:af73dc68e85f3bebb80ce302a642b9fe3b65f3df0ceb42eb9a27c467c1b678c8"},
+    {file = "rich_click-1.9.5.tar.gz", hash = "sha256:48120531493f1533828da80e13e839d471979ec8d7d0ca7b35f86a1379cc74b6"},
 ]
 
 [package.dependencies]
@@ -1057,30 +1056,30 @@ docs = ["markdown-include (>=0.8.1)", "mike (>=2.1.3)", "mkdocs-github-admonitio
 
 [[package]]
 name = "ruff"
-version = "0.14.9"
+version = "0.14.10"
 description = "An extremely fast Python linter and code formatter, written in Rust."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "ruff-0.14.9-py3-none-linux_armv6l.whl", hash = "sha256:f1ec5de1ce150ca6e43691f4a9ef5c04574ad9ca35c8b3b0e18877314aba7e75"},
+    {file = "ruff-0.14.10-py3-none-linux_armv6l.whl", hash = "sha256:7a3ce585f2ade3e1f29ec1b92df13e3da262178df8c8bdf876f48fa0e8316c49"},
-    {file = "ruff-0.14.9-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:ed9d7417a299fc6030b4f26333bf1117ed82a61ea91238558c0268c14e00d0c2"},
+    {file = "ruff-0.14.10-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:674f9be9372907f7257c51f1d4fc902cb7cf014b9980152b802794317941f08f"},
-    {file = "ruff-0.14.9-py3-none-macosx_11_0_arm64.whl", hash = "sha256:d5dc3473c3f0e4a1008d0ef1d75cee24a48e254c8bed3a7afdd2b4392657ed2c"},
+    {file = "ruff-0.14.10-py3-none-macosx_11_0_arm64.whl", hash = "sha256:d85713d522348837ef9df8efca33ccb8bd6fcfc86a2cde3ccb4bc9d28a18003d"},
-    {file = "ruff-0.14.9-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:84bf7c698fc8f3cb8278830fb6b5a47f9bcc1ed8cb4f689b9dd02698fa840697"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6987ebe0501ae4f4308d7d24e2d0fe3d7a98430f5adfd0f1fead050a740a3a77"},
-    {file = "ruff-0.14.9-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:aa733093d1f9d88a5d98988d8834ef5d6f9828d03743bf5e338bf980a19fce27"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:16a01dfb7b9e4eee556fbfd5392806b1b8550c9b4a9f6acd3dbe6812b193c70a"},
-    {file = "ruff-0.14.9-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6a1cfb04eda979b20c8c19550c8b5f498df64ff8da151283311ce3199e8b3648"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7165d31a925b7a294465fa81be8c12a0e9b60fb02bf177e79067c867e71f8b1f"},
-    {file = "ruff-0.14.9-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:1e5cb521e5ccf0008bd74d5595a4580313844a42b9103b7388eca5a12c970743"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:c561695675b972effb0c0a45db233f2c816ff3da8dcfbe7dfc7eed625f218935"},
-    {file = "ruff-0.14.9-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:cd429a8926be6bba4befa8cdcf3f4dd2591c413ea5066b1e99155ed245ae42bb"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4bb98fcbbc61725968893682fd4df8966a34611239c9fd07a1f6a07e7103d08e"},
-    {file = "ruff-0.14.9-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ab208c1b7a492e37caeaf290b1378148f75e13c2225af5d44628b95fd7834273"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f24b47993a9d8cb858429e97bdf8544c78029f09b520af615c1d261bf827001d"},
-    {file = "ruff-0.14.9-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:72034534e5b11e8a593f517b2f2f2b273eb68a30978c6a2d40473ad0aaa4cb4a"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:59aabd2e2c4fd614d2862e7939c34a532c04f1084476d6833dddef4afab87e9f"},
-    {file = "ruff-0.14.9-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:712ff04f44663f1b90a1195f51525836e3413c8a773574a7b7775554269c30ed"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:213db2b2e44be8625002dbea33bb9c60c66ea2c07c084a00d55732689d697a7f"},
-    {file = "ruff-0.14.9-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:a111fee1db6f1d5d5810245295527cda1d367c5aa8f42e0fca9a78ede9b4498b"},
+    {file = "ruff-0.14.10-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:b914c40ab64865a17a9a5b67911d14df72346a634527240039eb3bd650e5979d"},
-    {file = "ruff-0.14.9-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:8769efc71558fecc25eb295ddec7d1030d41a51e9dcf127cbd63ec517f22d567"},
+    {file = "ruff-0.14.10-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:1484983559f026788e3a5c07c81ef7d1e97c1c78ed03041a18f75df104c45405"},
-    {file = "ruff-0.14.9-py3-none-musllinux_1_2_i686.whl", hash = "sha256:347e3bf16197e8a2de17940cd75fd6491e25c0aa7edf7d61aa03f146a1aa885a"},
+    {file = "ruff-0.14.10-py3-none-musllinux_1_2_i686.whl", hash = "sha256:c70427132db492d25f982fffc8d6c7535cc2fd2c83fc8888f05caaa248521e60"},
-    {file = "ruff-0.14.9-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:7715d14e5bccf5b660f54516558aa94781d3eb0838f8e706fb60e3ff6eff03a8"},
+    {file = "ruff-0.14.10-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:5bcf45b681e9f1ee6445d317ce1fa9d6cba9a6049542d1c3d5b5958986be8830"},
-    {file = "ruff-0.14.9-py3-none-win32.whl", hash = "sha256:df0937f30aaabe83da172adaf8937003ff28172f59ca9f17883b4213783df197"},
+    {file = "ruff-0.14.10-py3-none-win32.whl", hash = "sha256:104c49fc7ab73f3f3a758039adea978869a918f31b73280db175b43a2d9b51d6"},
-    {file = "ruff-0.14.9-py3-none-win_amd64.whl", hash = "sha256:c0b53a10e61df15a42ed711ec0bda0c582039cf6c754c49c020084c55b5b0bc2"},
+    {file = "ruff-0.14.10-py3-none-win_amd64.whl", hash = "sha256:466297bd73638c6bdf06485683e812db1c00c7ac96d4ddd0294a338c62fdc154"},
-    {file = "ruff-0.14.9-py3-none-win_arm64.whl", hash = "sha256:8e821c366517a074046d92f0e9213ed1c13dbc5b37a7fc20b07f79b64d62cc84"},
+    {file = "ruff-0.14.10-py3-none-win_arm64.whl", hash = "sha256:e51d046cf6dda98a4633b8a8a771451107413b0f07183b2bef03f075599e44e6"},
-    {file = "ruff-0.14.9.tar.gz", hash = "sha256:35f85b25dd586381c0cc053f48826109384c81c00ad7ef1bd977bfcc28119d5b"},
+    {file = "ruff-0.14.10.tar.gz", hash = "sha256:9a2e830f075d1a42cd28420d7809ace390832a490ed0966fe373ba288e77aaf4"},
 ]
 
 [[package]]
@@ -1096,7 +1095,6 @@ files = [
 
 [package.dependencies]
 anyio = ">=3.6.2,<5"
-typing-extensions = {version = ">=4.10.0", markers = "python_version < \"3.13\""}
 
 [package.extras]
 full = ["httpx (>=0.27.0,<0.29.0)", "itsdangerous", "jinja2", "python-multipart (>=0.0.18)", "pyyaml"]
@@ -1156,13 +1154,13 @@ zstd = ["backports-zstd (>=1.0.0)"]
 
 [[package]]
 name = "uvicorn"
-version = "0.38.0"
+version = "0.40.0"
 description = "The lightning-fast ASGI server."
 optional = false
-python-versions = ">=3.9"
+python-versions = ">=3.10"
 files = [
-    {file = "uvicorn-0.38.0-py3-none-any.whl", hash = "sha256:48c0afd214ceb59340075b4a052ea1ee91c16fbc2a9b1469cca0e54566977b02"},
+    {file = "uvicorn-0.40.0-py3-none-any.whl", hash = "sha256:c6c8f55bc8bf13eb6fa9ff87ad62308bbbc33d0b67f84293151efe87e0d5f2ee"},
-    {file = "uvicorn-0.38.0.tar.gz", hash = "sha256:fd97093bdd120a2609fc0d3afe931d4d4ad688b6e75f0f929fde1bc36fe0e91d"},
+    {file = "uvicorn-0.40.0.tar.gz", hash = "sha256:839676675e87e73694518b5574fd0f24c9d97b46bea16df7b8c05ea1a51071ea"},
 ]
 
 [package.dependencies]
@@ -1219,5 +1217,5 @@ files = [
 
 [metadata]
 lock-version = "2.0"
-python-versions = "^3.12"
+python-versions = "==3.14.2"
-content-hash = "6204ac4c938e73f59f5bffef08e8e3cdbbc5c307a693578b1183d6140d4e8f31"
+content-hash = "7046b2edca4660e38f5f14ef0282854a4bb7892af5028c4af9e968f2c65590c5"