Merge pull request #7 from PredicateSystems/demo

Demo

Author: rcholic

.gitignore

@@ -56,3 +56,8 @@ traces/
 artifacts/
 tmp/
 temp/
+
+# Demo output and runtime files
+demo/.env
+demo/output/
+demo/*.log

.pre-commit-config.yaml

@@ -6,7 +6,9 @@ repos:
     rev: v4.5.0
     hooks:
       - id: trailing-whitespace
+        exclude: ^(venv/|\.venv/|build/|dist/|demo/)
       - id: end-of-file-fixer
+        exclude: ^(venv/|\.venv/|build/|dist/|demo/)
       - id: check-yaml
       - id: check-json
       - id: check-added-large-files
@@ -33,7 +35,7 @@ repos:
     hooks:
       - id: isort
         args: ["--profile=black", "--line-length=100"]
-        exclude: ^(venv/|\.venv/|build/|dist/)
+        exclude: ^(venv/|\.venv/|build/|dist/|demo/)
 
   # Flake8 for style guide enforcement
   - repo: https://github.com/pycqa/flake8
@@ -78,14 +80,6 @@ repos:
         args: ["--py311-plus"]
         exclude: ^(venv/|\.venv/|build/|dist/)
 
-  # Markdown linting for docs-heavy workflows
-  - repo: https://github.com/DavidAnson/markdownlint-cli2
-    rev: v0.14.0
-    hooks:
-      - id: markdownlint-cli2
-        args: ["--config", ".markdownlint.yaml"]
-        files: \.md$
-
 default_language_version:
   python: python3.11
 

README.md

@@ -29,6 +29,8 @@ pip install predicate-secure[all]
 
 ## Quick Start
 
+[User Manual](./docs/user-manual.md)
+
 ```python
 from predicate_secure import SecureAgent
 from browser_use import Agent

demo/.env.example

@@ -0,0 +1,23 @@
+# Predicate Secure Demo Environment Variables
+# Copy from .env.example and customize
+
+# Browser display (false = show browser for debugging)
+BROWSER_HEADLESS=false
+
+# Predicate API key (optional - leave unset to use FREE TIER)
+# Free tier uses local browser extension only (sufficient for demo)
+# PREDICATE_API_KEY=
+
+# LLM model for verification
+LLM_MODEL_NAME=Qwen/Qwen2.5-7B-Instruct
+LLM_DEVICE=auto
+LLM_MAX_TOKENS=512
+LLM_TEMPERATURE=0.0
+
+# Demo task
+DEMO_TASK_ID=example-search-task
+DEMO_START_URL=https://www.example.com
+DEMO_TASK_DESCRIPTION=Navigate to example.com and verify page loads
+DEMO_PRINCIPAL_ID=agent:demo-browser
+DEMO_TENANT_ID=tenant-demo
+DEMO_OUTPUT_DIR=demo/output