fix: install dashboard package + normalize DB URL in Alembic; add screenshots and demo GIF

Author: kohsheen1234

README.md

@@ -8,6 +8,10 @@
 
 📖 **Live documentation:** <https://kohsheen1234.github.io/Open-source-AI-Incident-Observatory/>
 
+![AgentWatch demo](docs/assets/demo.gif)
+
+*The dashboard, API docs, and Grafana metrics — running the full stack against 84 real incidents (replay + live Hacker News).*
+
 As AI systems increasingly act on their own — running tools, taking actions, and
 operating with growing autonomy — people are posting about what happens when those
 systems behave in unexpected or unintended ways: an agent that deletes the wrong
@@ -45,6 +49,16 @@ time.
   managed Postgres. (A live interactive app needs a host account; the docs site above
   is always-on and needs nothing.)
 
+## Screenshots
+
+| Dashboard — Overview | Dashboard — Incident Explorer |
+|---|---|
+| ![Overview](docs/assets/screenshots/01-overview.png) | ![Incident Explorer](docs/assets/screenshots/02-explorer.png) |
+
+| Dashboard — Review Queue | API — OpenAPI docs | Grafana — metrics |
+|---|---|---|
+| ![Review Queue](docs/assets/screenshots/03-review.png) | ![API docs](docs/assets/screenshots/04-api-docs.png) | ![Grafana](docs/assets/screenshots/05-grafana.png) |
+
 ## Run the whole system
 
 With Docker installed:

docs/assets/demo.gif

@@ -11,6 +11,8 @@ across forums and social platforms, and the original posts often disappear.
 AgentWatch exists to turn that scattered, disappearing evidence into a durable,
 searchable, and analysable record.
 
+![AgentWatch demo](assets/demo.gif)
+
 !!! info "Project status"
     The end-to-end pipeline is built and runnable today: the data foundation, the
     ingestion pipeline (pluggable collectors, evidence storage, normalisation,

docs/assets/screenshots/01-overview.png

@@ -4,9 +4,12 @@
 from agentwatch.config import get_settings
 from agentwatch.db import models  # noqa: F401 - register tables
 from agentwatch.db.base import Base
+from agentwatch.db.session import normalize_database_url
 
 config = context.config
-config.set_main_option("sqlalchemy.url", get_settings().database_url)
+# Normalise provider URLs (e.g. Render's postgresql://) to the psycopg3 driver,
+# matching the application engine.
+config.set_main_option("sqlalchemy.url", normalize_database_url(get_settings().database_url))
 target_metadata = Base.metadata
 
 

docs/assets/screenshots/02-explorer.png

@@ -33,7 +33,7 @@ requires = ["setuptools>=68"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools.packages.find]
-include = ["agentwatch*"]
+include = ["agentwatch*", "dashboard*"]
 
 [tool.setuptools.package-data]
 agentwatch = ["collectors/fixtures/*.json", "eval/*.json"]