Add private workspace generator

Author: hutaobo

.env.example

@@ -4,6 +4,13 @@ APP_PORT=8000
 OPENAI_API_KEY=
 OPENAI_MODEL=gpt-5.4
 OPENAI_EMBEDDING_MODEL=text-embedding-3-large
+PATHOLOGY_PROJECT_NAME=Pathology RAG Workbench
+PATHOLOGY_PROJECT_SLUG=pathology-rag-workbench
+COMPOSE_PROJECT_NAME=pathology-rag-workbench
+PATHOLOGY_CLIENT_COMMAND=pathology-client
+PATHOLOGY_INGEST_COMMAND=pathology-ingest-local
+PATHOLOGY_OPENCLAW_SKILL_NAME=pathology-rag
+PATHOLOGY_INSTALL_GLOBAL_ALIAS=1
 PATHOLOGY_PDF_ROOT=pathologybook
 PATHOLOGY_DATA_DIR=data
 PATHOLOGY_LIBRARY_CONFIG=config/library.local.yaml
@@ -12,5 +19,9 @@ PATHOLOGY_CHUNK_OVERLAP=120
 PATHOLOGY_TOP_K=6
 PATHOLOGY_EMBEDDING_DIMENSIONS=3072
 PATHOLOGY_EMBEDDING_BATCH_SIZE=16
+POSTGRES_DB=pathology_ai
+POSTGRES_USER=pathology
+POSTGRES_PASSWORD=pathology
+POSTGRES_PORT=5432
 POSTGRES_URL=postgresql+psycopg://pathology:pathology@localhost:5432/pathology_ai
 OPENCLAW_PATHOLOGY_API=http://127.0.0.1:8000

Makefile

@@ -1,7 +1,7 @@
 PYTHON := .venv/bin/python
 PIP := .venv/bin/pip
 
-.PHONY: bootstrap doctor ingest api test docker-up docker-down portable-up portable-bundle ui
+.PHONY: bootstrap doctor ingest api test docker-up docker-down portable-up portable-bundle ui init-private
 
 bootstrap:
 	bash scripts/bootstrap.sh
@@ -32,3 +32,7 @@ portable-up:
 
 portable-bundle:
 	bash scripts/package_portable.sh
+
+init-private:
+	@test -n "$(TARGET)" || (echo "Usage: make init-private TARGET=/absolute/path/to/private-workspace [NAME='My Private Workspace']"; exit 1)
+	python3 scripts/init_private_workspace.py "$(TARGET)" $(if $(NAME),--name "$(NAME)",)

README.md

@@ -40,6 +40,34 @@ This path is designed to work even when:
 - you do not have an OpenAI API key yet
 - you are cloning the repo onto a new machine for the first time
 
+## Generate a Private Workspace
+
+If you do not want to work directly in this public repository, you can use it as a generator for a new private local project.
+
+Example:
+
+```bash
+bash scripts/init_private_workspace.sh ~/Projects/my-private-pathology --name "My Private Pathology"
+```
+
+That command creates a new workspace folder with:
+
+- its own `.env`
+- its own `config/library.local.yaml`
+- a namespaced Docker Compose project name
+- isolated API and PostgreSQL host ports
+- namespaced CLI wrapper names such as `pathology-client-my-private-pathology`
+- an optional fresh git repository
+
+Then you switch into the generated folder and deploy it there:
+
+```bash
+cd ~/Projects/my-private-pathology
+bash scripts/deploy_portable.sh --allow-no-openai
+```
+
+This is the closest path to generating a new local project that behaves like the original private `pathology-ai` setup, but without carrying over public git history or shared runtime settings.
+
 ## Five-Minute Onboarding
 
 ### 1. Prerequisites
@@ -206,6 +234,7 @@ Direct script entrypoints:
 ```bash
 bash scripts/doctor.sh
 bash scripts/bootstrap.sh
+bash scripts/init_private_workspace.sh ~/Projects/my-private-pathology --name "My Private Pathology"
 bash scripts/deploy_portable.sh --allow-no-openai
 bash scripts/package_portable.sh
 ```

docker-compose.yml

@@ -2,11 +2,11 @@ services:
   postgres:
     image: pgvector/pgvector:pg17
     environment:
-      POSTGRES_DB: pathology_ai
-      POSTGRES_USER: pathology
-      POSTGRES_PASSWORD: pathology
+      POSTGRES_DB: ${POSTGRES_DB:-pathology_ai}
+      POSTGRES_USER: ${POSTGRES_USER:-pathology}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-pathology}
     ports:
-      - "5432:5432"
+      - "${POSTGRES_PORT:-5432}:5432"
     volumes:
       - postgres_data:/var/lib/postgresql/data
       - ./infra/docker/init.sql:/docker-entrypoint-initdb.d/init.sql:ro
@@ -21,9 +21,9 @@ services:
       OPENAI_API_KEY: ${OPENAI_API_KEY}
       PATHOLOGY_PDF_ROOT: /app/pathologybook
       PATHOLOGY_DATA_DIR: /app/data
-      POSTGRES_URL: postgresql+psycopg://pathology:pathology@postgres:5432/pathology_ai
+      POSTGRES_URL: postgresql+psycopg://${POSTGRES_USER:-pathology}:${POSTGRES_PASSWORD:-pathology}@postgres:5432/${POSTGRES_DB:-pathology_ai}
     ports:
-      - "8000:8000"
+      - "${APP_PORT:-8000}:8000"
     volumes:
       - .:/app
     depends_on:
@@ -40,7 +40,7 @@ services:
       OPENAI_API_KEY: ${OPENAI_API_KEY}
       PATHOLOGY_PDF_ROOT: /app/pathologybook
       PATHOLOGY_DATA_DIR: /app/data
-      POSTGRES_URL: postgresql+psycopg://pathology:pathology@postgres:5432/pathology_ai
+      POSTGRES_URL: postgresql+psycopg://${POSTGRES_USER:-pathology}:${POSTGRES_PASSWORD:-pathology}@postgres:5432/${POSTGRES_DB:-pathology_ai}
     volumes:
       - .:/app
     depends_on: