Setup & Run (Index)

Quick Access

  • App: http://127.0.0.1:8000/
  • Sign In: http://127.0.0.1:8000/sign_in.html
  • Wiki: http://127.0.0.1:8000/wiki/

This page collects the most common setup and run steps for the local development environment.

1) Install dependencies

cd "d:\WebDev\DigitalAssetMgrPro\stitch_digital_asset_manager_pro"
python -m pip install -r requirements.txt

2) Initialize the database (creates users.db and a test user)

python init_db.py

3) Add or update users (recommended for adding real accounts)

Interactive (recommended):

python add_user.py --email your-email@example.com
# type the password at the prompt

Scripted (for automation):

python add_user.py --email your-email@example.com --password "StrongPassword!"

4) Start the Flask app

python server.py
# visit http://127.0.0.1:8000/

5) Start the local documentation wiki

python -m mkdocs serve -a 127.0.0.1:8001
# visit http://127.0.0.1:8001/

6) Test login (PowerShell example):

(Invoke-WebRequest -Method POST -Uri http://127.0.0.1:8000/api/login -Body (@{email='you@example.com';password='YourPassword'} | ConvertTo-Json) -ContentType 'application/json' -UseBasicParsing).Content

7) Access the protected wiki

After signing in via /sign_in.html, open the protected docs at:

Start-Process "http://127.0.0.1:8000/wiki/"

If you try to open /wiki/ while not signed in the server will redirect you to /sign_in.html.

7) Next steps / TODOs

  • Add session or JWT-based auth
  • Migrate to Postgres/MySQL for production
  • Add HTTPS and deploy behind a web server