zrb 1.0.0a20__py3-none-any.whl → 1.0.0a21__py3-none-any.whl

zrb/config.py

@@ -71,10 +71,10 @@ WEB_REFRESH_TOKEN_COOKIE_NAME = os.getenv(
 WEB_SECRET_KEY = os.getenv("ZRB_WEB_SECRET", "zrb")
 WEB_ENABLE_AUTH = to_boolean(os.getenv("ZRB_WEB_ENABLE_AUTH", "0"))
 WEB_AUTH_ACCESS_TOKEN_EXPIRE_MINUTES = int(
-    os.getenv("ZRB_WEB_ACCESS_TOKEN_EXPIRE", "30")
+    os.getenv("ZRB_WEB_ACCESS_TOKEN_EXPIRE_MINUTES", "30")
 )
 WEB_AUTH_REFRESH_TOKEN_EXPIRE_MINUTES = int(
-    os.getenv("ZRB_WEB_ACCESS_TOKEN_EXPIRE", f"{60*24*7}")
+    os.getenv("ZRB_WEB_REFRESH_TOKEN_EXPIRE_MINUTES", "60")
 )
 LLM_MODEL = os.getenv("ZRB_LLM_MODEL", "ollama_chat/llama3.1")
 LLM_SYSTEM_PROMPT = os.getenv("ZRB_LLM_SYSTEM_PROMPT", "You are a helpful assistant")

zrb/runner/refresh-token.template.js

@@ -0,0 +1,22 @@
+function refreshAuthToken(){
+    const refreshUrl = "/api/v1/refresh-token";
+    async function refresh() {
+        try {
+            const response = await fetch(refreshUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                credentials: "include", // Include cookies in the request
+            });
+
+            if (!response.ok) {
+                throw new Error(`HTTP error! Status: ${response.status}`);
+            }
+            console.log("Token refreshed successfully");
+        } catch (error) {
+            console.error("Cannot refresh token", error)
+        }
+    }
+    setInterval(refresh, refreshIntervalSeconds * 1000);
+    refresh();
+}
+refreshAuthToken();

zrb/runner/web_app.py

@@ -2,21 +2,26 @@ import asyncio
 import json
 import os
 import sys
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from typing import TYPE_CHECKING, Annotated
 
 from zrb.config import BANNER, VERSION
 from zrb.context.shared_context import SharedContext
 from zrb.group.any_group import AnyGroup
 from zrb.runner.common_util import get_run_kwargs
-from zrb.runner.web_config import Token, WebConfig
+from zrb.runner.web_config import (
+    NewSessionResponse,
+    RefreshTokenRequest,
+    Token,
+    WebConfig,
+)
 from zrb.runner.web_controller.error_page.controller import show_error_page
 from zrb.runner.web_controller.group_info_page.controller import show_group_info_page
 from zrb.runner.web_controller.home_page.controller import show_home_page
 from zrb.runner.web_controller.login_page.controller import show_login_page
 from zrb.runner.web_controller.logout_page.controller import show_logout_page
 from zrb.runner.web_controller.session_page.controller import show_session_page
-from zrb.runner.web_util import NewSessionResponse
+from zrb.runner.web_util import get_refresh_token_js
 from zrb.session.session import Session
 from zrb.session_state_log.session_state_log import SessionStateLog, SessionStateLogList
 from zrb.session_state_logger.any_session_state_logger import AnySessionStateLogger
@@ -35,9 +40,17 @@ def create_app(
 ) -> "FastAPI":
     from contextlib import asynccontextmanager
 
-    from fastapi import Depends, FastAPI, HTTPException, Query, Request, Response
+    from fastapi import (
+        Cookie,
+        Depends,
+        FastAPI,
+        HTTPException,
+        Query,
+        Request,
+        Response,
+    )
     from fastapi.openapi.docs import get_swagger_ui_html
-    from fastapi.responses import FileResponse, HTMLResponse
+    from fastapi.responses import FileResponse, HTMLResponse, PlainTextResponse
     from fastapi.security import OAuth2PasswordRequestForm
     from fastapi.staticfiles import StaticFiles
 
@@ -72,6 +85,15 @@ def create_app(
             return FileResponse(full_path)
         raise HTTPException(status_code=404, detail="File not found")
 
+    @app.get("/refresh-token.js", include_in_schema=False)
+    async def refresh_token_js():
+        return PlainTextResponse(
+            content=get_refresh_token_js(
+                60 * web_config.refresh_token_expire_minutes / 3
+            ),
+            media_type="application/javascript",
+        )
+
     @app.get("/docs", include_in_schema=False)
     async def swagger_ui_html():
         return get_swagger_ui_html(
@@ -85,12 +107,12 @@ def create_app(
     @app.get("/ui", response_class=HTMLResponse, include_in_schema=False)
     @app.get("/ui/", response_class=HTMLResponse, include_in_schema=False)
     async def home_page_ui(request: Request) -> HTMLResponse:
-        user = await web_config.get_user_by_request(request)
+        user = await web_config.get_user_from_request(request)
         return show_home_page(user, root_group)
 
     @app.get("/ui/{path:path}", response_class=HTMLResponse, include_in_schema=False)
     async def ui_page(path: str, request: Request) -> HTMLResponse:
-        user = await web_config.get_user_by_request(request)
+        user = await web_config.get_user_from_request(request)
         # Avoid capturing '/ui' itself
         if not path:
             return show_error_page(user, root_group, 422, "Undefined path")
@@ -116,46 +138,66 @@ def create_app(
 
     @app.get("/login", response_class=HTMLResponse, include_in_schema=False)
     async def login(request: Request) -> HTMLResponse:
-        user = await web_config.get_user_by_request(request)
+        user = await web_config.get_user_from_request(request)
         return show_login_page(user, root_group)
 
     @app.get("/logout", response_class=HTMLResponse, include_in_schema=False)
     async def logout(request: Request) -> HTMLResponse:
-        user = await web_config.get_user_by_request(request)
+        user = await web_config.get_user_from_request(request)
         return show_logout_page(user, root_group)
 
     @app.post("/api/v1/login")
     async def login_api(
         response: Response, form_data: Annotated[OAuth2PasswordRequestForm, Depends()]
     ):
-        token = web_config.generate_tokens(
+        token = web_config.generate_tokens_by_credentials(
             username=form_data.username, password=form_data.password
         )
+        if token is None:
+            raise HTTPException(
+                status_code=400, detail="Incorrect username or password"
+            )
         _set_auth_cookie(response, token)
         return token
 
     @app.post("/api/v1/refresh-token")
     async def refresh_token_api(
-        response: Response, refresh_token: str = Query(..., description="Refresh token")
+        response: Response,
+        body: RefreshTokenRequest = None,
+        refresh_token_cookie: str = Cookie(
+            None, alias=web_config.refresh_token_cookie_name
+        ),
     ):
-        token = web_config.refresh_tokens(refresh_token)
-        _set_auth_cookie(response, token)
-        return token
+        # Try to get the refresh token from the request body first
+        refresh_token = body.refresh_token if body else None
+        # If not in the body, try to get it from the cookie
+        if not refresh_token:
+            refresh_token = refresh_token_cookie
+        # If we still don't have a refresh token, raise an exception
+        if not refresh_token:
+            raise HTTPException(status_code=400, detail="Refresh token not provided")
+        # Get token
+        new_token = web_config.regenerate_tokens(refresh_token)
+        _set_auth_cookie(response, new_token)
+        return new_token
 
     def _set_auth_cookie(response: Response, token: Token):
+        access_token_max_age = web_config.access_token_expire_minutes * 60
+        refresh_token_max_age = web_config.refresh_token_expire_minutes * 60
+        now = datetime.now(timezone.utc)
         response.set_cookie(
             key=web_config.access_token_cookie_name,
             value=token.access_token,
             httponly=True,
-            max_age=web_config.access_token_max_age,
-            expires=web_config.access_token_max_age,
+            max_age=access_token_max_age,
+            expires=now + timedelta(seconds=access_token_max_age),
         )
         response.set_cookie(
             key=web_config.refresh_token_cookie_name,
             value=token.refresh_token,
             httponly=True,
-            max_age=web_config.refresh_token_max_age,
-            expires=web_config.refresh_token_max_age,
+            max_age=refresh_token_max_age,
+            expires=now + timedelta(seconds=refresh_token_max_age),
         )
 
     @app.get("/api/v1/logout")
@@ -165,15 +207,15 @@ def create_app(
         response.delete_cookie(web_config.refresh_token_cookie_name)
         return {"message": "Logout successful"}
 
-    @app.post("/api/sessions/{path:path}")
-    async def create_new_session_api(
+    @app.post("/api/v1/task-sessions/{path:path}")
+    async def create_new_task_session_api(
         path: str,
         request: Request,
     ) -> NewSessionResponse:
         """
         Creating new session
         """
-        user = await web_config.get_user_by_request(request)
+        user = await web_config.get_user_from_request(request)
         args = path.strip("/").split("/")
         task, _, residual_args = extract_node_from_args(root_group, args)
         if isinstance(task, AnyTask):
@@ -190,7 +232,7 @@ def create_app(
                 return NewSessionResponse(session_name=session.name)
         raise HTTPException(status_code=404)
 
-    @app.get("/api/inputs/{path:path}", response_model=dict[str, str])
+    @app.get("/api/v1/task-inputs/{path:path}", response_model=dict[str, str])
     async def get_default_inputs_api(
         path: str,
         request: Request,
@@ -199,7 +241,7 @@ def create_app(
         """
         Getting input completion for path
         """
-        user = await web_config.get_user_by_request(request)
+        user = await web_config.get_user_from_request(request)
         args = path.strip("/").split("/")
         task, _, _ = extract_node_from_args(root_group, args)
         if isinstance(task, AnyTask):
@@ -213,7 +255,7 @@ def create_app(
         raise HTTPException(status_code=404, detail="Not Found")
 
     @app.get(
-        "/api/sessions/{path:path}",
+        "/api/v1/task-sessions/{path:path}",
         response_model=SessionStateLog | SessionStateLogList,
     )
     async def get_session_api(
@@ -227,7 +269,7 @@ def create_app(
         """
         Getting existing session or sessions
         """
-        user = await web_config.get_user_by_request(request)
+        user = await web_config.get_user_from_request(request)
         args = path.strip("/").split("/")
         task, _, residual_args = extract_node_from_args(root_group, args)
         if isinstance(task, AnyTask) and residual_args:

zrb/runner/web_config.py

@@ -24,6 +24,14 @@ if TYPE_CHECKING:
     from fastapi import Request
 
 
+class NewSessionResponse(BaseModel):
+    session_name: str
+
+
+class RefreshTokenRequest(BaseModel):
+    refresh_token: str
+
+
 class User(BaseModel):
     model_config = ConfigDict(arbitrary_types_allowed=True)
     username: str
@@ -73,51 +81,31 @@ class WebConfig:
         guest_accessible_tasks: list[AnyTask | str] = [],
         find_user_by_username: Callable[[str], User | None] | None = None,
     ):
-        self._secret_key = secret_key
-        self._access_token_expire_minutes = access_token_expire_minutes
-        self._refresh_token_expire_minutes = refresh_token_expire_minutes
-        self._access_token_cookie_name = access_token_cookie_name
-        self._refresh_token_cookie_name = refresh_token_cookie_name
-        self._enable_auth = enable_auth
-        self._port = port
+        self.secret_key = secret_key
+        self.access_token_expire_minutes = access_token_expire_minutes
+        self.refresh_token_expire_minutes = refresh_token_expire_minutes
+        self.access_token_cookie_name = access_token_cookie_name
+        self.refresh_token_cookie_name = refresh_token_cookie_name
+        self.enable_auth = enable_auth
+        self.port = port
         self._user_list = []
-        self._super_admin_username = super_admin_username
-        self._super_admin_password = super_admin_password
-        self._guest_username = guest_username
-        self._guest_accessible_tasks = guest_accessible_tasks
+        self.super_admin_username = super_admin_username
+        self.super_admin_password = super_admin_password
+        self.guest_username = guest_username
+        self.guest_accessible_tasks = guest_accessible_tasks
         self._find_user_by_username = find_user_by_username
 
-    @property
-    def port(self) -> int:
-        return self._port
-
-    @property
-    def access_token_cookie_name(self) -> str:
-        return self._access_token_cookie_name
-
-    @property
-    def refresh_token_cookie_name(self) -> str:
-        return self._refresh_token_cookie_name
-
-    @property
-    def access_token_max_age(self) -> int:
-        self._access_token_expire_minutes * 60
-
-    @property
-    def refresh_token_max_age(self) -> int:
-        self._refresh_token_expire_minutes * 60
-
     @property
     def default_user(self) -> User:
-        if self._enable_auth:
+        if self.enable_auth:
             return User(
-                username=self._guest_username,
+                username=self.guest_username,
                 password="",
                 is_guest=True,
-                accessible_tasks=self._guest_accessible_tasks,
+                accessible_tasks=self.guest_accessible_tasks,
             )
         return User(
-            username=self._guest_username,
+            username=self.guest_username,
             password="",
             is_guest=True,
             is_super_admin=True,
@@ -126,19 +114,19 @@ class WebConfig:
     @property
     def super_admin(self) -> User:
         return User(
-            username=self._super_admin_username,
-            password=self._super_admin_password,
+            username=self.super_admin_username,
+            password=self.super_admin_password,
             is_super_admin=True,
         )
 
     @property
     def user_list(self) -> list[User]:
-        if not self._enable_auth:
+        if not self.enable_auth:
             return [self.default_user]
         return self._user_list + [self.super_admin, self.default_user]
 
     def set_guest_accessible_tasks(self, tasks: list[AnyTask | str]):
-        self._guest_accessible_tasks = tasks
+        self.guest_accessible_tasks = tasks
 
     def set_find_user_by_username(
         self, find_user_by_username: Callable[[str], User | None]
@@ -155,12 +143,6 @@ class WebConfig:
             raise ValueError(f"User already exists {user.username}")
         self._user_list.append(user)
 
-    def enable_auth(self):
-        self._enable_auth = True
-
-    def disable_auth(self):
-        self._enable_auth = False
-
     def find_user_by_username(self, username: str) -> User | None:
         user = None
         if self._find_user_by_username is not None:
@@ -169,10 +151,10 @@ class WebConfig:
             user = next((u for u in self.user_list if u.username == username), None)
         return user
 
-    async def get_user_by_request(self, request: "Request") -> User | None:
+    async def get_user_from_request(self, request: "Request") -> User | None:
         from fastapi.security import OAuth2PasswordBearer
 
-        if not self._enable_auth:
+        if not self.enable_auth:
             return self.default_user
         # Normally we use "Depends"
         get_bearer_token = OAuth2PasswordBearer(
@@ -193,7 +175,7 @@ class WebConfig:
 
             payload = jwt.decode(
                 token,
-                self._secret_key,
+                self.secret_key,
                 options={"require_sub": True, "require_exp": True},
             )
             username: str = payload.get("sub")
@@ -207,43 +189,47 @@ class WebConfig:
             return None
 
     def _get_user_from_cookie(self, request: "Request") -> User | None:
-        token = request.cookies.get(self._access_token_cookie_name)
+        token = request.cookies.get(self.access_token_cookie_name)
         if token:
             return self._get_user_from_token(token)
         return None
 
-    def get_user_by_credentials(self, username: str, password: str) -> User:
+    def get_user_by_credentials(self, username: str, password: str) -> User | None:
         user = self.find_user_by_username(username)
         if user is None or not user.is_password_match(password):
-            return self.default_user
+            return None
         return user
 
-    def generate_tokens(self, username: str, password: str) -> Token:
-        if not self._enable_auth:
+    def generate_tokens_by_credentials(
+        self, username: str, password: str
+    ) -> Token | None:
+        if not self.enable_auth:
             user = self.default_user
         else:
             user = self.get_user_by_credentials(username, password)
-        access_token = self.create_access_token(user.username)
-        refresh_token = self.create_refresh_token(user.username)
+        if user is None:
+            return None
+        access_token = self._generate_access_token(user.username)
+        refresh_token = self._generate_refresh_token(user.username)
         return Token(
             access_token=access_token, refresh_token=refresh_token, token_type="bearer"
         )
 
-    def create_access_token(self, username: str) -> str:
+    def _generate_access_token(self, username: str) -> str:
         from jose import jwt
 
-        expire = datetime.now() + timedelta(minutes=self._access_token_expire_minutes)
+        expire = datetime.now() + timedelta(minutes=self.access_token_expire_minutes)
         to_encode = {"sub": username, "exp": expire, "type": "access"}
-        return jwt.encode(to_encode, self._secret_key)
+        return jwt.encode(to_encode, self.secret_key)
 
-    def create_refresh_token(self, username: str) -> str:
+    def _generate_refresh_token(self, username: str) -> str:
         from jose import jwt
 
-        expire = datetime.now() + timedelta(minutes=self._refresh_token_expire_minutes)
+        expire = datetime.now() + timedelta(minutes=self.refresh_token_expire_minutes)
         to_encode = {"sub": username, "exp": expire, "type": "refresh"}
-        return jwt.encode(to_encode, self._secret_key)
+        return jwt.encode(to_encode, self.secret_key)
 
-    def refresh_tokens(self, refresh_token: str) -> Token:
+    def regenerate_tokens(self, refresh_token: str) -> Token:
         from fastapi import HTTPException
         from jose import jwt
 
@@ -251,7 +237,7 @@ class WebConfig:
         try:
             payload = jwt.decode(
                 refresh_token,
-                self._secret_key,
+                self.secret_key,
                 options={"require_exp": True, "require_sub": True},
             )
         except Exception:
@@ -265,8 +251,8 @@ class WebConfig:
         if user is None:
             raise HTTPException(status_code=401, detail="User not found")
         # Create new token
-        new_access_token = self.create_access_token(username)
-        new_refresh_token = self.create_refresh_token(username)
+        new_access_token = self._generate_access_token(username)
+        new_refresh_token = self._generate_refresh_token(username)
         return Token(
             access_token=new_access_token,
             refresh_token=new_refresh_token,

zrb/runner/web_controller/error_page/view.html

@@ -30,4 +30,5 @@
                 <p>{error_message}</p>
         </main>
     </body>
+    <script src="/refresh-token.js"></script>
 </html>

zrb/runner/web_controller/group_info_page/view.html

@@ -33,4 +33,5 @@
                 {task_info}
         </main>
     </body>
+    <script src="/refresh-token.js"></script>
 </html>

zrb/runner/web_controller/home_page/view.html

@@ -29,4 +29,5 @@
                 {task_info}
         </main>
     </body>
+    <script src="/refresh-token.js"></script>
 </html>

zrb/runner/web_controller/login_page/view.html

@@ -45,6 +45,7 @@
         </article>
     </main>
     <script src="/static/login/event.js"></script>
+    <script src="/refresh-token.js"></script>
 </body>
 
 </html>

zrb/runner/web_controller/logout_page/view.html

@@ -35,6 +35,7 @@
         </article>
     </main>
     <script src="/static/logout/event.js"></script>
+    <script src="/refresh-token.js"></script>
 </body>
 
 </html>

zrb/runner/web_controller/session_page/controller.py

@@ -33,11 +33,11 @@ def show_session_page(
     parent_url = "/".join(parent_url_parts)
     # Assemble session api url
     session_url_parts = list(url_parts)
-    session_url_parts[1] = "api/sessions"
+    session_url_parts[1] = "api/v1/task-sessions"
     session_api_url = "/".join(session_url_parts)
     # Assemble input api url
     input_url_parts = list(url_parts)
-    input_url_parts[1] = "api/inputs"
+    input_url_parts[1] = "api/v1/task-inputs"
     input_api_url = "/".join(input_url_parts)
     # Assemble ui url
     ui_url_parts = list(url_parts)

zrb/runner/web_controller/session_page/view.html

@@ -88,4 +88,5 @@
     <script src="/static/session/past-session.js"></script>
     <script src="/static/session/current-session.js"></script>
     <script src="/static/session/event.js"></script>
+    <script src="/refresh-token.js"></script>
 </html>

zrb/runner/web_controller/static/session/current-session.js

@@ -1,5 +1,5 @@
 const CURRENT_SESSION = {
-    async pollCurrentSession() {
+    async startPolling() {
         const resultTextarea = document.getElementById("result-textarea");
         const logTextarea = document.getElementById("log-textarea");
         const submitTaskForm = document.getElementById("submit-task-form");

zrb/runner/web_controller/static/session/event.js

@@ -1,7 +1,7 @@
 window.addEventListener("load", async function () {
     // Get current session
     if (cfg.SESSION_NAME != "") {
-        CURRENT_SESSION.pollCurrentSession();
+        CURRENT_SESSION.startPolling();
     }
     // set maxStartDate to today
     const tomorrow = new Date();
@@ -16,8 +16,6 @@ window.addEventListener("load", async function () {
     const formattedToday = UTIL.toLocalDateInputValue(today);
     const minStartAtInput = document.getElementById("min-start-at-input");
     minStartAtInput.value = formattedToday;
-    // Update session
-    PAST_SESSION.pollPastSession();
 });
 
 
@@ -63,11 +61,12 @@ submitTaskForm.addEventListener("input", async function(event) {
     } catch (error) {
         console.error("Error during fetch:", error);
     }
-})
+});
 
 
 function openPastSessionDialog(event) {
     event.preventDefault();
+    PAST_SESSION.startPolling();
     const dialog = document.getElementById("past-session-dialog")
     dialog.showModal();
 }
@@ -75,6 +74,7 @@ function openPastSessionDialog(event) {
 
 function closePastSessionDialog(event) {
     event.preventDefault();
+    PAST_SESSION.stopPolling();
     const dialog = document.getElementById("past-session-dialog")
     dialog.close();
 }
@@ -109,8 +109,7 @@ async function submitNewSessionForm(event) {
             const data = await response.json();
             cfg.SESSION_NAME = data.session_name;
             history.pushState(null, "", `${cfg.CURRENT_URL}${cfg.SESSION_NAME}`);
-            await PAST_SESSION.getAndRenderPastSession(0);
-            await CURRENT_SESSION.pollCurrentSession();
+            await CURRENT_SESSION.startPolling();
         } else {
             console.error("Error:", response);
         }

zrb/runner/web_controller/static/session/past-session.js

@@ -1,12 +1,18 @@
 const PAST_SESSION = {
+    shouldPoll: true,
 
-    async pollPastSession() {
-        while (true) {
-            await this.getAndRenderPastSession(cfg.PAGE);
+    async startPolling() {
+        await this.getAndRenderPastSession(cfg.PAGE);
+        while (this.shouldPoll) {
             await UTIL.delay(5000);
+            await this.getAndRenderPastSession(cfg.PAGE);
         }
     },
 
+    stopPolling() {
+        this.shouldPoll = false;
+    },
+
     async getAndRenderPastSession(page) {
         cfg.PAGE=page
         const minStartAtInput = document.getElementById("min-start-at-input");

zrb/runner/web_util.py

@@ -1,15 +1,12 @@
-from pydantic import BaseModel
+import os
 
 from zrb.group.any_group import AnyGroup
 from zrb.runner.web_config import User
 from zrb.task.any_task import AnyTask
+from zrb.util.file import read_file
 from zrb.util.group import get_non_empty_subgroups, get_subtasks
 
 
-class NewSessionResponse(BaseModel):
-    session_name: str
-
-
 def url_to_args(url: str) -> list[str]:
     stripped_url = url.strip("/")
     return [part for part in stripped_url.split("/") if part.strip() != ""]
@@ -29,6 +26,14 @@ def get_html_auth_link(user: User) -> str:
     return f'Hi, {user.username} <a href="/logout">Logout 🚪</a>'
 
 
+def get_refresh_token_js(refresh_interval_seconds: int):
+    _DIR = os.path.dirname(__file__)
+    return read_file(
+        os.path.join(_DIR, "refresh-token.template.js"),
+        {"refreshIntervalSeconds": f"{refresh_interval_seconds}"},
+    )
+
+
 def get_html_subtask_info(user: User, parent_url: str, parent_group: AnyGroup) -> str:
     subtasks = get_subtasks(parent_group, web_only=True)
     task_li = "\n".join(

{zrb-1.0.0a20.dist-info → zrb-1.0.0a21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zrb
-Version: 1.0.0a20
+Version: 1.0.0a21
 Summary: Your Automation Powerhouse
 Home-page: https://github.com/state-alchemists/zrb
 License: AGPL-3.0-or-later
@@ -32,9 +32,11 @@ Description-Content-Type: text/markdown
 
 ![](https://raw.githubusercontent.com/state-alchemists/zrb/main/_images/zrb/android-chrome-192x192.png)
 
+[Documentation](https://github.com/state-alchemists/zrb/blob/main/docs/README.md)
+
 # 🤖 Zrb: Your Automation Powerhouse
 
-With Zrb, you can write your automation tasks like this:
+Zrb allows you to write your automation tasks in Python and declaratively:
 
 
 ```python
@@ -52,59 +54,13 @@ math.add_task(Task(
 ))
 ```
 
-You can then access the task in various ways.
-
-__Using CLI with arguments__
-
-```bash
-zrb math add 4 5
-```
-
-Result:
-
-```
-9
-To run again: zrb math add --a=4 --b=5
-```
-
-__Using CLI with keyword arguments__
-
-```bash
-zrb math add --a 4 --b 5
-```
-
-Result:
-
-```
-9
-To run again: zrb math add --a=4 --b=5
-```
-
-__Using CLI with incomplete arguments__
-
-```bash
-zrb math add 4
-```
-
-Result:
-
-```
-b [0]: 5
-9
-To run again: zrb math add 4
-```
-
-__Using Web Interface__
-
-```bash
-zrb server start
-```
+Once defined, you will be able to access your automation tasks from the CLI, Web Interface, or via HTTP API.
 
-Result (you need to access `http://localhost:21213`)
+For more complex scenario, you can also defined Task dependencies (upstreams) and retry mechanisms. You can also make a scheduled tasks, just like in Apache Airflow.
 
-![](https://raw.githubusercontent.com/state-alchemists/zrb/refs/heads/1.0.0/_images/web.png)
+Furthermore, Zrb has some builtin tasks to manage monorepo, generate FastAPI application, or play around with LLM.
 
-__More:__
+See the [getting started guide](https://github.com/state-alchemists/zrb/blob/main/docs/recipes/getting-started/README.md) for more information. Or just watch the demo:
 
 [![Video Title](https://img.youtube.com/vi/W7dgk96l__o/0.jpg)](https://www.youtube.com/watch?v=W7dgk96l__o)
 

{zrb-1.0.0a20.dist-info → zrb-1.0.0a21.dist-info}/RECORD

@@ -120,7 +120,7 @@ zrb/callback/callback.py,sha256=hKefB_Jd1XGjPSLQdMKDsGLHPzEGO2dqrIArLl_EmD0,848
 zrb/cmd/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/cmd/cmd_result.py,sha256=L8bQJzWCpcYexIxHBNsXj2pT3BtLmWex0iJSMkvimOA,597
 zrb/cmd/cmd_val.py,sha256=hr8Ge0FRe7FZStvkDYnd1MUOOiJW2lDOQqBv338Ymas,963
-zrb/config.py,sha256=tqOcu19vUxElbOOr0t55dbgVVD3ya6WoUP2PqlfY9N0,3823
+zrb/config.py,sha256=vZHW6ydp-o27FhMkz6aUYwH1UfEPbKacT55hb_GuSMk,3832
 zrb/content_transformer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/content_transformer/any_content_transformer.py,sha256=3XHM6ZdsJFXxRD7YlUkv0Gn7-mexsH8c8zdHt3C0x8k,741
 zrb/content_transformer/content_transformer.py,sha256=vNR8Z_fS7dG2A42O7scDG96JYKBz6IDuFa_B4zMVzZY,2012
@@ -152,35 +152,36 @@ zrb/input/text_input.py,sha256=7i0lvWYw79ILp0NEOBn-Twwnv7sBEgxJsqVaai6LzAA,3033
 zrb/runner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/runner/cli.py,sha256=ycus4N2T4sTdvLSxocyqjK3Atacm2vGRwpZuPhk9dDA,6573
 zrb/runner/common_util.py,sha256=JYBgNPSGyJHZo0X-Qp9sDi4B14NdcTi20n1fJP4SW3M,1298
-zrb/runner/web_app.py,sha256=7_j-FAJqHvFNN1q03iOC7Dw4tnd4uBwpAheH-LwMmnI,11404
-zrb/runner/web_config.py,sha256=9T21eEkyQYZpjdV9uAIn8um1leKL3VGB7M2SBrrxxvk,9852
+zrb/runner/refresh-token.template.js,sha256=v_nF7nU1AXp-KtsHNNzamhciEi7NCSTPEDT5hCxn29g,735
+zrb/runner/web_app.py,sha256=OjLYX3tRw1PiLkQdrmZkZ_cykknw4W9L8NFODL3tUGA,12866
+zrb/runner/web_config.py,sha256=pF6PE92fSAwsG1IobFbW4TGJY3Z4TUnlRzX1qxLFyqY,9428
 zrb/runner/web_controller/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/runner/web_controller/error_page/controller.py,sha256=Dh2vanfPMvc5aAW0rLYOd2WwUrcO1fGdNVk80-8Qzzs,857
-zrb/runner/web_controller/error_page/view.html,sha256=ZlC0oLRv5WXNI-iwP0TcOoQfP5jYZJ-8ojWx_055CcE,1110
+zrb/runner/web_controller/error_page/view.html,sha256=VI-q18Rffyn3T_EQptvn7tZ4qIYLVxj82YbazbXnYfY,1156
 zrb/runner/web_controller/group_info_page/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/runner/web_controller/group_info_page/controller.py,sha256=PBPCyVXILa7gCIC8d-0Exip7EAnTm3ch5GWe1Fs3WxI,1311
-zrb/runner/web_controller/group_info_page/view.html,sha256=X-LtSQcbJ2HwTWGSZhN0MhXaSI4OqDF26DzyXh1COJo,1234
+zrb/runner/web_controller/group_info_page/view.html,sha256=wISun627ciFZcvGpxANG0pr1zgUtSd1m1rNhCAYjRQw,1280
 zrb/runner/web_controller/home_page/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/runner/web_controller/home_page/controller.py,sha256=2e_Oarts9nnau7ZSdBDiqqvsw7qd7jsIB14BXAsu4FI,1008
-zrb/runner/web_controller/home_page/view.html,sha256=p1ZoX604_q8JEqyU2awXnqKUI2bR8RXSEF4hUsLLiLc,1024
+zrb/runner/web_controller/home_page/view.html,sha256=ee0O1bgoZO0qYVqaa67ad7wX_Zawqsy6F-ioxbjEQGk,1070
 zrb/runner/web_controller/login_page/controller.py,sha256=vCRGgp8mW5JnYt-sPzWdJLLqlaARQO2zTOHAcPzkqrw,733
-zrb/runner/web_controller/login_page/view.html,sha256=XANr3qHbAx3g8dGwx677zVeYbKiX5znEZPVi4oqnfcc,1715
+zrb/runner/web_controller/login_page/view.html,sha256=-MeHcSb3r0ouUhs-4aFgrlPjV_V7iz2a6PkobVpk77c,1761
 zrb/runner/web_controller/logout_page/controller.py,sha256=0mX3wyY5jNtI1Jnxfl_7N8fHtLfBwPE81x9yh2zO_u4,764
-zrb/runner/web_controller/logout_page/view.html,sha256=5hGZeil1Z4_oLRmkXdvXsDW12UFwlUt6u7wjDHvQS5s,1278
+zrb/runner/web_controller/logout_page/view.html,sha256=O17ow4-KMbxTkwaQgR880Rlt1B9pnHrRTlgu5nsM4LA,1324
 zrb/runner/web_controller/session_page/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-zrb/runner/web_controller/session_page/controller.py,sha256=bsnslbWLEGWyKdMtqvqXRZzGLAkvjIY2tVkvSOizN3s,2616
+zrb/runner/web_controller/session_page/controller.py,sha256=q7O8BeytX9kWyU24CMPXVW2cjkN5BQG5tAkr_kuUOXY,2632
 zrb/runner/web_controller/session_page/partial/input.html,sha256=X2jy0q7TLQGP853exZMed0lqPezL3gzn6mnhB5QKfkc,178
-zrb/runner/web_controller/session_page/view.html,sha256=k-jAF_AOOCcNg1vdqsXEHEQWOzkyyxPaaU2WqCIM3uM,3547
+zrb/runner/web_controller/session_page/view.html,sha256=CwrIiPJAwHEEIVNp_wkTzW7kQJjTh41FSDamCswI3S8,3593
 zrb/runner/web_controller/static/common.css,sha256=u5rGLsPx2943z324iQ2X81krM3z-kc-8e1SkBdYAvKU,157
 zrb/runner/web_controller/static/favicon-32x32.png,sha256=yu9AIU4k_qD4YHpul6XwJgOxIbmu0thv9ymm2QOsrAk,1456
 zrb/runner/web_controller/static/login/event.js,sha256=1-NxaUwU-X7Tu2RAwVkzU7gngS0OdooH7Ple4_KDrh4,1135
 zrb/runner/web_controller/static/logout/event.js,sha256=MfZxrTa2yL49Lbh7cCZDdqsIcf9e1q3W8-WjmZXV5pA,692
 zrb/runner/web_controller/static/pico.min.css,sha256=_Esfkjs_U_igYn-tXBUaK3AEKb7d4l9DlmaOiw9bXfI,82214
 zrb/runner/web_controller/static/session/common-util.js,sha256=t7_s5DXgMyZlT8L8LYZTkzOT6vWVeZvmCKjt-bflQY0,2117
-zrb/runner/web_controller/static/session/current-session.js,sha256=oA1OFWeRYJzowL8-5mMpy32m9hv-_T6MwAuVruP7XDw,6515
-zrb/runner/web_controller/static/session/event.js,sha256=NpFPV2kejUu_WSqfZgW57Un791L4NbmATujavcoIhrM,4217
-zrb/runner/web_controller/static/session/past-session.js,sha256=LP0ABMTm7Ap9t9G-JF4b_pRm7BCbh96D_IFb5p91FgA,5325
-zrb/runner/web_util.py,sha256=4t6DQ1Avb-aPaLCPB_Q3qaDOZssZ1oNsMBIW5MDqCIU,2262
+zrb/runner/web_controller/static/session/current-session.js,sha256=JV0VRFeizFigPqQiXIeW3By36FDDZhkRM_a8UI4mh-E,6509
+zrb/runner/web_controller/static/session/event.js,sha256=Bd3iW_XqWDlD6gJtSvFju-eT8vQzpkLHOcQU85quCWk,4154
+zrb/runner/web_controller/static/session/past-session.js,sha256=RwGJYKSp75K8NZ-iZP58XppWgdzkiKFaiC5wgcMLxDo,5470
+zrb/runner/web_util.py,sha256=9zAH9FkPM7anVNjRcwTjHyfFocfwpksaWQVYth_nuBc,2464
 zrb/session/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/session/any_session.py,sha256=x57mS15E-AfUjdVxwOWEzCBjW32zjer7WoeBw0guoDc,5266
 zrb/session/session.py,sha256=b89UdwPs0U9XXmTHNhCXFmcYXxuRVhNr94Dp_bVO3n4,9827
@@ -237,7 +238,7 @@ zrb/util/string/name.py,sha256=8picJfUBXNpdh64GNaHv3om23QHhUZux7DguFLrXHp8,1163
 zrb/util/todo.py,sha256=1nDdwPc22oFoK_1ZTXyf3638Bg6sqE2yp_U4_-frHoc,16015
 zrb/xcom/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/xcom/xcom.py,sha256=o79rxR9wphnShrcIushA0Qt71d_p3ZTxjNf7x9hJB78,1571
-zrb-1.0.0a20.dist-info/METADATA,sha256=u-FbzxbG3e53o9Q9_YN93QeDzSKbsF6jq82fJB7EHhQ,4164
-zrb-1.0.0a20.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-zrb-1.0.0a20.dist-info/entry_points.txt,sha256=-Pg3ElWPfnaSM-XvXqCxEAa-wfVI6BEgcs386s8C8v8,46
-zrb-1.0.0a20.dist-info/RECORD,,
+zrb-1.0.0a21.dist-info/METADATA,sha256=GzXMD38Yc32hIwuW55Pe1tMFB3_2j56o8Iz11qJtQOo,4185
+zrb-1.0.0a21.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+zrb-1.0.0a21.dist-info/entry_points.txt,sha256=-Pg3ElWPfnaSM-XvXqCxEAa-wfVI6BEgcs386s8C8v8,46
+zrb-1.0.0a21.dist-info/RECORD,,