[chore] improve the python app setup

Author: deepu105

py-langchain/README.md

@@ -41,21 +41,27 @@ To start with the basic examples, you'll just need to add your OpenAI API key an
 Next, install the required packages using your preferred package manager, e.g. uv:
 
 ```bash
-uv sync --frozen
+uv sync
 ```
 
-Now you're ready to start and migrate the database:
+Now you're ready to start the database:
 
 ```bash
 # start the postgres database
 docker compose up -d
 ```
 
+Initialize FGA store:
+
+```bash
+source .venv/bin/activate
+python -m app.core.fga_init
+```
+
 Now you're ready to run the development server:
 
 ```bash
 source .venv/bin/activate
-uv pip install auth0_fastapi # install the auth0 fastapi package
 fastapi dev app/main.py
 ```
 
@@ -77,6 +83,7 @@ Finally, you can start the frontend server in another terminal:
 
 ```bash
 cd frontend
+cp .env.example .env # Copy the `.env.example` file to `.env`.
 npm install
 npm run dev
 ```

py-langchain/backend/.env.example

@@ -6,6 +6,8 @@ AUTH0_CLIENT_ID=''
 AUTH0_CLIENT_SECRET=''
 
 OPENAI_API_KEY=''
+
+# Database
 DATABASE_URL="postgresql+psycopg://postgres:postgres@localhost:5432/ai_documents_db"
 
 # LANGGRAPH
@@ -18,6 +20,6 @@ FGA_CLIENT_SECRET=<your-fga-store-client-secret>
 FGA_API_URL=https://api.xxx.fga.dev
 FGA_API_AUDIENCE=https://api.xxx.fga.dev/
 
-# Shop API URL
-SHOP_API_URL="http://localhost:3001/api/shop"
-SHOP_API_AUDIENCE="https://api.shop-online-demo.com"
+# Shop API URL (Optional)
+# SHOP_API_URL="http://localhost:3001/api/shop"
+# SHOP_API_AUDIENCE="https://api.shop-online-demo.com"

py-langchain/backend/README.md

@@ -15,13 +15,34 @@ To start with the basic examples, you'll just need to add your OpenAI API key an
 Next, install the required packages using your preferred package manager, e.g. uv:
 
 ```bash
-uv sync --frozen
+uv sync
+```
+
+Now you're ready to start and migrate the database:
+
+```bash
+# start the postgres database
+docker compose up -d
+```
+
+Initialize FGA store:
+
+```bash
+source .venv/bin/activate
+python -m app.core.fga_init
 ```
 
 Now you're ready to run the development server:
 
 ```bash
 source .venv/bin/activate
-uv pip install auth0_fastapi # install the auth0 fastapi package
 fastapi dev app/main.py
 ```
+
+Next, you'll need to start an in-memory LangGraph server on port 54367, to do so open a new terminal and run:
+
+```bash
+source .venv/bin/activate
+uv pip install -U langgraph-api
+langgraph dev --port 54367 --allow-blocking
+```

py-langchain/backend/app/core/config.py

@@ -32,8 +32,8 @@ class Settings(BaseSettings):
     FGA_AUTHORIZATION_MODEL_ID: str | None = None
 
     # Shop API
-    SHOP_API_URL: str = "http://localhost:3001/api/shop"
-    SHOP_API_AUDIENCE: str = "https://api.shop-online-demo.com"
+    SHOP_API_URL: str = ""
+    SHOP_API_AUDIENCE: str = ""
 
     # OpenAI
     OPENAI_API_KEY: str

py-langchain/backend/app/core/fga_init.py

@@ -0,0 +1,52 @@
+import asyncio
+import json
+import os
+import openfga_sdk
+from openfga_sdk.client import OpenFgaClient
+from openfga_sdk.credentials import Credentials, CredentialConfiguration
+
+from app.core.config import settings
+
+
+def build_openfga_client() -> OpenFgaClient:
+    """Build and return an OpenFGA client using settings configuration."""
+    openfga_client_config = openfga_sdk.ClientConfiguration(
+        api_url=settings.FGA_API_URL,
+        store_id=settings.FGA_STORE_ID,
+        credentials=Credentials(
+            method="client_credentials",
+            configuration=CredentialConfiguration(
+                api_issuer=settings.FGA_API_TOKEN_ISSUER,
+                api_audience=settings.FGA_API_AUDIENCE,
+                client_id=settings.FGA_CLIENT_ID,
+                client_secret=settings.FGA_CLIENT_SECRET,
+            ),
+        ),
+    )
+    return OpenFgaClient(openfga_client_config)
+
+
+async def main():
+    """
+    Initializes the OpenFgaClient, writes an authorization model, and configures pre-defined tuples.
+
+    This function performs the following steps:
+       1. Creates an instance of OpenFgaClient with the necessary configuration.
+       2. Writes an authorization model with specified schema version and type definitions.
+    """
+    
+    fga_client = build_openfga_client()
+    
+    # Define the authorization model
+    body_string = "{\"schema_version\":\"1.1\",\"type_definitions\":[{\"type\":\"user\"},{\"metadata\":{\"relations\":{\"can_view\":{},\"owner\":{\"directly_related_user_types\":[{\"type\":\"user\"}]},\"viewer\":{\"directly_related_user_types\":[{\"type\":\"user\"},{\"type\":\"user\",\"wildcard\":{}}]}}},\"relations\":{\"can_view\":{\"union\":{\"child\":[{\"computedUserset\":{\"relation\":\"owner\"}},{\"computedUserset\":{\"relation\":\"viewer\"}}]}},\"owner\":{\"this\":{}},\"viewer\":{\"this\":{}}},\"type\":\"doc\"}]}"
+    # Write the authorization model
+    model = await fga_client.write_authorization_model(json.loads(body_string))
+    
+    print(f'NEW MODEL ID: {model.authorization_model_id}')
+    
+    # Properly close the client session
+    await fga_client.close()
+
+
+if __name__ == '__main__':
+    asyncio.run(main())

py-langchain/backend/app/core/schema.fga

@@ -0,0 +1,10 @@
+model
+  schema 1.1
+
+type user
+
+type doc
+  relations
+    define owner: [user]
+    define viewer: [user, user:*]
+    define can_view: owner or viewer

py-langchain/docker-compose.yml renamed to py-langchain/backend/docker-compose.yml

@@ -18,6 +18,7 @@
         "axios": "^1.10.0",
         "class-variance-authority": "^0.7.1",
         "clsx": "^2.1.1",
+        "date-fns": "^4.1.0",
         "lucide-react": "^0.525.0",
         "marked": "^16.1.1",
         "next-themes": "^0.4.6",
@@ -477,6 +478,8 @@
 
     "csstype": ["[email protected]", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
 
+    "date-fns": ["[email protected]", "", {}, "sha512-Ukq0owbQXxa/U3EGtsdVBkR1w7KOQ5gIBqdH2hkvknzZPYvBxb/aa6E8L7tmjFtkwZBu3UXBbjIgPo/Ez4xaNg=="],
+
     "debug": ["[email protected]", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ=="],
 
     "decamelize": ["[email protected]", "", {}, "sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA=="],

py-langchain/frontend/bun.lock

@@ -44,6 +44,8 @@ bun install # or npm install
 docker compose up -d
 # create the database schema
 bun db:migrate # or npm run db:migrate
+# initialize FGA store
+bun fga:init # or npm run fga:init
 ```
 
 Now you're ready to run the development server:

ts-langchain/README.md

@@ -45,6 +45,8 @@ bun install # or npm install
 docker compose up -d
 # create the database schema
 bun db:migrate # or npm run db:migrate
+# initialize FGA store
+bun fga:init # or npm run fga:init
 ```
 
 Now you're ready to run the development server: