### Start Polis Development Environment

Source: https://github.com/compdemocracy/polis/blob/edge/README.md

Copies the example environment file and starts the development server with default configurations. May require adjusting port conflicts on macOS.

```sh
cp example.env .env
make start
```

--------------------------------

### Install Dependencies

Source: https://github.com/compdemocracy/polis/blob/edge/client-participation/DEV_SERVER.md

Install project dependencies using npm. This is the first step before starting the development server.

```bash
npm install
```

--------------------------------

### Python Environment Setup

Source: https://github.com/compdemocracy/polis/blob/edge/deploy/README.md

Set up a Python virtual environment, activate it, and install project dependencies from `requirements.txt` and `dev-requirements.txt`.

```bash
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -r dev-requirements.txt
```

--------------------------------

### Setup Local Development Environment

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/umap_narrative/polismath_commentgraph/README.md

Installs project dependencies and the EVoC library for local development. Ensure you are in a Python virtual environment.

```bash
python -m venv delphi-env
source delphi-env/bin/activate
pip install -r requirements.txt

# Install EVOC from local directory
pip install -e ../evoc-main
```

--------------------------------

### Setup MinIO Bucket

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/S3_STORAGE.md

Run this Python script after starting MinIO to create the necessary bucket for storing Delphi visualizations.

```python
python delphi/setup_minio_bucket.py
```

--------------------------------

### Clone and Start Docker Containers

Source: https://github.com/compdemocracy/polis/wiki/Running-E2E-tests-locally

Clone the project repository and start the application within Docker containers. Ensure Docker and docker-compose are installed.

```bash
git clone https://github.com/compdemocracy/polis
cd polis
make pull
make start
```

--------------------------------

### Start Full Dev Environment

Source: https://github.com/compdemocracy/polis/blob/edge/CLAUDE.md

Use this command to start the full development environment. It utilizes the .env file for configuration.

```bash
make start
```

--------------------------------

### Run Development Server

Source: https://github.com/compdemocracy/polis/blob/edge/server/README.md

Installs dependencies, compiles TypeScript, and starts the API server in development mode with hot-reloading. For production, use 'npm install' and 'npm start'.

```sh
npm run dev
```

--------------------------------

### Install mkcert

Source: https://github.com/compdemocracy/polis/blob/edge/oidc-simulator/README.md

Install mkcert for local certificate generation. Includes installation for macOS with Homebrew and a link for other platforms.

```bash
# macOS with Homebrew
brew install mkcert
brew install nss # if you use Firefox

# Other platforms: https://github.com/FiloSottile/mkcert#installation
```

--------------------------------

### Launch Jupyter Notebook Server

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/QUICK_START.md

Starts the Jupyter notebook server for interactive analysis, assuming Jupyter is installed.

```bash
jupyter notebook biodiversity_analysis.ipynb
```

--------------------------------

### Copy Example .env File

Source: https://github.com/compdemocracy/polis/blob/edge/server/README.md

Copies the example environment file to .env for local configuration. Ensure to edit this file with your specific settings.

```sh
cp example.env .env
```

--------------------------------

### Install Node and Dependencies

Source: https://github.com/compdemocracy/polis/blob/edge/client-admin/README.md

Use mise to set the Node version to 24 and install npm dependencies. Ensure mise is installed first.

```sh
# Install mise: https://mise.jdx.dev/getting-started.html
mise use node@24
npm install
```

--------------------------------

### Start Production Mode Environment

Source: https://github.com/compdemocracy/polis/blob/edge/CLAUDE.md

Starts the development environment in production mode, using the prod.env configuration file.

```bash
make PROD start
```

--------------------------------

### Start client-report Development Server

Source: https://github.com/compdemocracy/polis/blob/edge/client-report/CLAUDE.md

Navigate to the client-report directory and start the development server with a specified service URL. This server runs on port 5010.

```bash
cd /Users/colinmegill/polis/client-report
SERVICE_URL=http://localhost npm start
```

--------------------------------

### Launch Notebook Server

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/RUNNING_THE_SYSTEM.md

Navigate to the notebook directory and execute the launch script to start a notebook server.

```bash
cd delphi/eda_notebooks
./launch_notebook.sh
```

--------------------------------

### Install Dependencies

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/umap_narrative/README.md

Installs the required Python packages for the project. Ensure you have Python and pip installed.

```bash
pip install -r requirements.txt
```

--------------------------------

### Start and Rebuild Docker Containers

Source: https://github.com/compdemocracy/polis/blob/edge/README.md

A Makefile shortcut to rebuild and start the Docker containers.

```sh
make start-rebuild
```

--------------------------------

### Install and Run Pol.is Math System

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/summary.md

Instructions for installing the Python package and running the system from the command line. Includes options for custom configuration, port, and log level.

```bash
pip install -e .
polismath
polismath --config config.yaml --port 8000 --log-level DEBUG
```

--------------------------------

### Start Development Server

Source: https://github.com/compdemocracy/polis/blob/edge/client-participation/DEV_SERVER.md

Start the webpack development server for rapid development. This command enables hot module replacement and automatic reloading.

```bash
npm run dev
```

```bash
npm start
```

--------------------------------

### Example: Monitor Batch Job

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/BATCH_NARRATIVE_README.md

Example command to monitor a specific batch job with `--watch` enabled.

```bash
python 803_check_batch_status.py --batch_id batch_12345_1620000000_abcd1234 --watch
```

--------------------------------

### Start Docker Compose for MinIO

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/S3_STORAGE.md

Use this command to start the Docker containers, including MinIO, for local S3-compatible storage development.

```bash
docker compose up -d
```

--------------------------------

### Start Development Server

Source: https://github.com/compdemocracy/polis/blob/edge/client-admin/README.md

Run the webpack dev server to start the application. It will automatically rebuild as changes are made. Access the interface at http://localhost:8080.

```sh
npm start
```

--------------------------------

### Install SSL Certificates with mkcert

Source: https://github.com/compdemocracy/polis/blob/edge/CLAUDE.md

Installs mkcert and generates necessary SSL certificates for local development, including OIDC simulator support. Requires Homebrew.

```bash
# Install SSL certificates
brew install mkcert nss
mkcert -install
mkcert -CAROOT
```

--------------------------------

### Example: Submit Batch Job

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/BATCH_NARRATIVE_README.md

Example command to submit a batch job for conversation ID '12345'.

```bash
python 801_narrative_report_batch.py --conversation_id 12345
```

--------------------------------

### Run Client Development Server

Source: https://github.com/compdemocracy/polis/blob/edge/CLAUDE.md

Starts the local development server for the client-participation-alpha application on port 4321.

```bash
cd client-participation-alpha
npm run dev
```

--------------------------------

### Start OIDC Simulator

Source: https://github.com/compdemocracy/polis/blob/edge/server/__tests__/integration/README.md

Use this command to start the OIDC simulator, which is required for JWT authentication tests. It provides pre-registered test users.

```bash
docker compose -f docker-compose.yml -f docker-compose.dev.yml up oidc-simulator
```

```bash
docker compose -f docker-compose.yml -f docker-compose.dev.yml up
```

--------------------------------

### Start Development Environment with OIDC Simulator

Source: https://github.com/compdemocracy/polis/blob/edge/oidc-simulator/README.md

Starts all development services, including the OIDC Simulator, using Docker Compose. Ensures the simulator is running for local development.

```bash
# Start all services including oidc-simulator
make start
```

```bash
# Or with Docker Compose directly
docker compose --profile postgres -f docker-compose.yml -f docker-compose.dev.yml up
```

--------------------------------

### Install Project Dependencies

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/QUICK_START.md

Installs the 'polismath' package in development mode and additional visualization tools. This should be run after activating the virtual environment.

```bash
pip install -e .

pip install matplotlib seaborn jupyter
```

--------------------------------

### Example Report Route URLs

Source: https://github.com/compdemocracy/polis/blob/edge/client-report/REPORT_ROUTES.md

These are example URLs demonstrating how to access different report types within the application. Replace '2arcefpshi' with your specific report ID.

```http
http://localhost:5010/report/2arcefpshi
```

```http
http://localhost:5010/commentsReport/2arcefpshi
```

```http
http://localhost:5010/topicStats/2arcefpshi
```

```http
http://localhost:5010/narrativeReport/2arcefpshi
```

--------------------------------

### Check Analysis Environment Setup

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/QUICK_START.md

Verifies that the environment is correctly set up for running the analysis scripts.

```bash
python run_analysis.py --check
```

--------------------------------

### Job Logs Example

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/JOB_QUEUE_SCHEMA.md

Example format for job logs, including recent entries with timestamps, levels, and messages, as well as a location for full log storage.

```json
{
  "entries": [
    {"timestamp": "2025-04-23T21:34:12Z", "level": "INFO", "message": "Started PCA calculation"},
    {"timestamp": "2025-04-23T21:35:22Z", "level": "INFO", "message": "PCA completed with 2 components"},
    {"timestamp": "2025-04-23T21:35:23Z", "level": "ERROR", "message": "Failed to save results to S3"}
  ],
  "log_location": "s3://polis-logs/jobs/job-123-456.log"
}
```

--------------------------------

### PCA Job Configuration Example

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/JOB_QUEUE_SCHEMA.md

Example configuration for a Principal Component Analysis (PCA) job, specifying parameters like max votes, batch size, and PCA method.

```json
{
  "max_votes": 1000000,
  "batch_size": 50000,
  "n_components": 2,
  "pca_method": "randomized"
}
```

--------------------------------

### Set up MinIO Bucket

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/README.md

Initializes the MinIO bucket required for storing conversation visualizations.

```bash
# Set up the MinIO bucket for visualization storage
python setup_minio_bucket.py
```

--------------------------------

### Start a Docker Machine

Source: https://github.com/compdemocracy/polis/blob/edge/docs/docker-machine.md

Initiates a stopped Docker Machine, making it available for use.

```bash
docker-machine start <name>
```

--------------------------------

### Build Client for Production

Source: https://github.com/compdemocracy/polis/blob/edge/CLAUDE.md

Creates a production-ready build of the client-participation-alpha application.

```bash
cd client-participation-alpha
npm run build
```

--------------------------------

### Run OIDC Simulator Standalone

Source: https://github.com/compdemocracy/polis/blob/edge/oidc-simulator/README.md

Installs dependencies and starts the OIDC Simulator independently for standalone usage. This is an alternative to running it as part of the full development environment.

```bash
cd oidc-simulator
npm install
npm run dev
```

--------------------------------

### Get Default Model Provider

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/umap_narrative/llm_factory_constructor/README.md

Retrieves the default LLM provider based on environment variable configuration. This is the simplest way to start using the model integration.

```python
from llm_factory_constructor import get_model_provider

# Get default provider (checks environment variables)
provider = get_model_provider()

# Get response from model
response = provider.get_response(
    system_message="You are a helpful assistant.",
    user_message="What is the meaning of life?"
)
```

--------------------------------

### Use setupOidcReadiness for Global Setup

Source: https://github.com/compdemocracy/polis/blob/edge/e2e/OIDC-WAIT-USAGE-GUIDE.md

Recommended for test suites with multiple files using OIDC. This command automatically handles CI vs. local environments.

```javascript
// Option A: Use the setupOidcReadiness command (Recommended)
describe('My Test Suite', () => {
  before(() => {
    cy.setupOidcReadiness() // Automatically handles CI vs local
  })

  it('should work', () => {
    // OIDC will be ready before this runs
  })
})

// Option B: Call waitForOidcReady directly for custom configuration
describe('My Test Suite', () => {
  before(() => {
    if (Cypress.env('CI')) {
      cy.waitForOidcReady({ timeout: 30000, retries: 5 })
    }
  })
})
```

--------------------------------

### Install mkcert for Local SSL Certificates

Source: https://github.com/compdemocracy/polis/blob/edge/README.md

Installs mkcert, a tool for generating locally trusted SSL certificates. Ensure nss is installed if using Firefox. Refer to the mkcert GitHub for other platforms.

```shell
# Install mkcert (macOS with Homebrew)
brew install mkcert
brew install nss  # if you use Firefox

# Other platforms: https://github.com/FiloSottile/mkcert#installation
```

--------------------------------

### Preview Client Production Build

Source: https://github.com/compdemocracy/polis/blob/edge/CLAUDE.md

Serves the production build of the client-participation-alpha application locally for preview.

```bash
cd client-participation-alpha
npm run preview
```

--------------------------------

### Example Integration in Report Generation

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/umap_narrative/llm_factory_constructor/README.md

Demonstrates how to dynamically select an LLM provider and model based on configuration or arguments, and then use it for generating model responses within a report generation system.

```python
from llm_factory_constructor import get_model_provider

# Configuration
provider_type = "anthropic" if use_anthropic else "ollama"
model_name = args.model  # Command line argument

# Get provider
provider = get_model_provider(provider_type, model_name)

# Use in report generation
model_response = provider.get_response(
    system_message=system_lore,
    user_message=prompt_xml
)
```

--------------------------------

### Start nREPL without Docker Compose

Source: https://github.com/compdemocracy/polis/blob/edge/math/README.md

If not using Docker Compose, this command starts the nREPL for the math component. Note that this will not start the processing queue or other system components. Ensure the DATABASE_URL environment variable is set.

```sh
clj -M:dev
```

--------------------------------

### Run Simple Demo Script

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/RUNNING_THE_SYSTEM.md

Execute the simple demo script to showcase basic system capabilities.

```python
python simple_demo.py
```

--------------------------------

### Install E2E Dependencies

Source: https://github.com/compdemocracy/polis/wiki/Running-E2E-tests-locally

Install the necessary dependencies for running end-to-end tests using Cypress.

```bash
make e2e-install
```

--------------------------------

### Dataset Directory Structure Example

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/regression_testing.md

Illustrates the expected directory structure for datasets, distinguishing between committed and local datasets.

```bash
real_data/
├── r6vbnhffkxbd7ifmfbdrd-vw/           # Committed
├── r4tytfkwac8thvzv35jrn53-biodiversity/ # Committed
└── .local/                              # Git-ignored
    ├── rexample1234-myconvo/
    ├── rexample5678-otherconvo/
    └── ...
```

--------------------------------

### Start Docker Compose

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/README.md

Starts the necessary Docker services for the development environment in detached mode.

```bash
docker-compose up -d
```

--------------------------------

### Removed Import Statement Example 8

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/DEAD_CODE_CLEANUP_REPORT.md

Example of specific imports removed from the 'clusters.py' file.

```python
from polismath.pca_kmeans_rep.clusters import weighted_mean, weighted_means

```

--------------------------------

### Removed Import Statement Example 7

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/DEAD_CODE_CLEANUP_REPORT.md

Example of a specific import removed from the 'corr.py' file.

```python
from polismath.pca_kmeans_rep.corr import squareform

```

--------------------------------

### Bootstrap Participant UI with GET /api/v3/participationInit

Source: https://context7.com/compdemocracy/polis/llms.txt

Use this endpoint to fetch all necessary data for initializing the participant interface. Pass `includePCA=false` to optimize load times by excluding PCA results. An external user ID (XID) can be provided for embedded contexts.

```bash
# Bootstrap a participation session for conversation "3fphs6v6xy"
curl -s "https://pol.is/api/v3/participationInit?conversation_id=3fphs6v6xy&lang=en&includePCA=true" \
  -H "Authorization: Bearer $JWT_TOKEN" | jq '{
    user: .user,
    nextComment: .nextComment,
    pca_groups: (.pca.repness | length),
    votes_cast: (.votes | length),
    conversation_topic: .conversation.topic
  }'
```

```json
# Expected output:
# {
#   "user": { "uid": 42, "hname": "Alice" },
#   "nextComment": { "tid": 17, "txt": "We should prioritize public transit.", "currentPid": 5 },
#   "pca_groups": 3,
#   "votes_cast": 12,
#   "conversation_topic": "City transport policy 2025"
# }
```

```bash
# With XID (external user identity, e.g. from an embedding site):
curl -s "https://pol.is/api/v3/participationInit?conversation_id=3fphs6v6xy&xid=user-abc-123&lang=en"
```

--------------------------------

### Removed Import Statement Example 5

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/DEAD_CODE_CLEANUP_REPORT.md

Example of a specific import removed from the 'postgres.py' file.

```python
from polismath.database.postgres import JSON, QueuePool

```

--------------------------------

### Run in Production Mode

Source: https://github.com/compdemocracy/polis/blob/edge/README.md

Starts the application in production mode using Makefile shortcuts, ignoring the development overlay and exposing only essential ports.

```sh
make PROD start
```

```sh
make PROD start-rebuild
```

--------------------------------

### Removed Import Statement Example 3

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/DEAD_CODE_CLEANUP_REPORT.md

Example of a specific import removed from the 'postgres.py' file.

```python
from polismath.utils.general import postgres_vote_to_delphi

```

--------------------------------

### Example: Process Batch Results

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/BATCH_NARRATIVE_README.md

Example command to process the results of a completed batch job.

```bash
python 802_process_batch_results.py --batch_id batch_12345_1620000000_abcd1234
```

--------------------------------

### Local Development Environment Configuration

Source: https://context7.com/compdemocracy/polis/llms.txt

Setup instructions for local development using Docker Compose. Includes copying environment variables and defining key settings for database, API, math engine, AWS, and OIDC.

```bash
# Minimum required .env for local development (copy from example.env):
cp example.env .env

# Key environment variables:
DATABASE_URL=postgres://postgres:password@localhost:5432/polis-dev
POSTGRES_HOST=localhost:5432
POSTGRES_USER=postgres
POSTGRES_PASSWORD=password
POSTGRES_DB=polis-dev

# API server
API_DEV_HOSTNAME=localhost:5000
DEV_MODE=true
SERVER_LOG_LEVEL=debug

# Math engine
MATH_ENV=dev
MATH_LOG_LEVEL=info

# AWS (required for data export and Delphi features):
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=your-key-id
AWS_SECRET_ACCESS_KEY=your-secret

# DynamoDB local for development (Delphi topics):
DYNAMODB_ENDPOINT=http://localhost:8000

# OIDC authentication (optional):
OIDC_ISSUER=https://auth.example.com
OIDC_CLIENT_ID=polis-client
OIDC_CLIENT_SECRET=secret

# Start all services:
docker compose up
```

--------------------------------

### Python Additional Dependencies Installation

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/TESTING_LOG.md

Installs extra Python packages for data visualization and notebook usage.

```bash
pip install matplotlib seaborn jupyter
```

--------------------------------

### Python Virtual Environment Setup

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/TESTING_LOG.md

Commands to create and activate a new Python virtual environment for project development.

```bash
python3 -m venv delphi-env
source delphi-env/bin/activate
```

--------------------------------

### Start Development Environment in Background

Source: https://github.com/compdemocracy/polis/blob/edge/CLAUDE.md

Starts the development environment and detaches the containers, allowing them to run in the background.

```bash
make DETACH=true start
```

--------------------------------

### Create and Activate Virtual Environment

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/RUNNING_THE_SYSTEM.md

Navigate to the project directory and create a Python virtual environment for managing dependencies. Activate the environment before proceeding with package installation.

```bash
cd delphi

python -m venv delphi-env

# On Linux/macOS
source delphi-env/bin/activate
# On Windows
delphi-env\Scripts\activate
```

--------------------------------

### Removed Import Statement Example

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/DEAD_CODE_CLEANUP_REPORT.md

Example of an import statement that was removed as part of the dead code cleanup.

```python
from polismath.utils.general import AGREE, DISAGREE

```

--------------------------------

### Verify Cold-Start Blob Creation

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/SESSION_HANDOFF_KMEANS.md

Navigate to the `delphi` directory and use `ls -lh` to check the existence and size of cold-start blobs. `jq` can be used for a quick inspection of the blob's content, such as the number of keys.

```bash
cd delphi  # from worktree root

# Check file exists and size
ls -lh real_data/r4tykwac8thvzv35jrn53-biodiversity/*cold_start*.json

# Quick inspection of content
jq 'keys | length' real_data/r4tykwac8thvzv35jrn53-biodiversity/r4tykwac8thvzv35jrn53_math_blob_cold_start.json

# Compare file sizes (cold-start should be similar to original)
ls -lh real_data/r4tykwac8thvzv35jrn53-biodiversity/*_math_blob*.json
```

--------------------------------

### Removed Import Statement Example 2

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/DEAD_CODE_CLEANUP_REPORT.md

Another example of an import statement that was removed as part of the dead code cleanup.

```python
from polismath.utils.general import weighted_mean, weighted_means

```

--------------------------------

### Install Local Certificate Authority

Source: https://github.com/compdemocracy/polis/blob/edge/oidc-simulator/README.md

Installs the local Certificate Authority (CA) for mkcert, which is required for generating trusted local certificates.

```bash
mkcert -install
```

--------------------------------

### Setup Test Conversation

Source: https://github.com/compdemocracy/polis/blob/edge/e2e/PARTICIPANT-TESTING.md

Use `setupTestConversation` to create a conversation with initial comments for testing purposes. The conversation object is returned in a promise.

```javascript
before(() => {
  // Create test conversation with comments
  setupTestConversation({
    topic: 'Test Conversation',
    comments: ['Comment 1', 'Comment 2', 'Comment 3'],
  }).then((conversation) => {
    testConversation = conversation
  })
})
```

--------------------------------

### Example requirements.lock file structure

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/DOCKER_BUILD_OPTIMIZATION.md

An example of the structure of a requirements.lock file generated by pip-compile, showing pinned versions and dependency origins.

```txt
# requirements.lock (generated by pip-compile)
#
# This file is autogenerated by pip-compile with Python 3.13
# by the following command:
#
#    pip-compile --output-file=requirements.lock pyproject.toml
#
numpy==1.26.4
    # via
    #   delphi-polis (pyproject.toml)
    #   pandas
    #   scikit-learn
pandas==2.3.3
    # via delphi-polis (pyproject.toml)
...
```

--------------------------------

### Connect to Database and Run Migrations

Source: https://github.com/compdemocracy/polis/blob/edge/server/README.md

Connects to the 'polis' database and applies initial SQL migrations. This step can be skipped if using docker compose for database setup.

```psql
\connect polis
\i postgres/migrations/000000_initial.sql
\i postgres/migrations/000001_update_pwreset_table.sql
\i postgres/migrations/000002_add_xid_constraint.sql
\i postgres/migrations/000003_add_origin_permanent_cookie_columns.sql
\i postgres/migrations/000004_drop_waitinglist_table.sql
\i postgres/migrations/000005_drop_slack_stripe_canvas.sql
\i postgres/migrations/000006_update_votes_rule.sql
\i postgres/migrations/000007_drop_geolocation_fields.sql
\i postgres/migrations/000008_add_comment_priority.sql
\i postgres/migrations/000009_add_uuid_to_zinvites.sql
```

--------------------------------

### Set Up Demo Conversation with Synthetic Votes

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/usage_examples.md

Initialize a Pol.is conversation manager and create a demo conversation, then generate synthetic votes for participants and comments.

```python
from polismath.conversation import ConversationManager
import random

# Create a manager
manager = ConversationManager()

# Create conversation
conv_id = "demo-conversation"
manager.create_conversation(conv_id)

# Generate synthetic votes
participants = [f"p{i}" for i in range(100)]
comments = [f"c{i}" for i in range(20)]


```

--------------------------------

### Replace Authentication Setup Before and After

Source: https://github.com/compdemocracy/polis/blob/edge/server/__tests__/integration/README.md

Illustrates the change in authentication setup from using deprecated registration and login to the new JWT authenticated agent.

```typescript
const auth = await registerAndLoginUser();
const agent = auth.agent;
```

```typescript
const { agent } = await getJwtAuthenticatedAgent(testUser);
```

--------------------------------

### Run Simplified Tests

Source: https://github.com/compdemocracy/polis/blob/edge/delphi/docs/QUICK_START.md

Executes the core algorithms with minimal dependencies. This is the most reliable way to test the system.

```bash
python run_tests.py --simplified
```