pylogue 0.2.1__tar.gz → 0.3.29__tar.gz

{pylogue-0.2.1 → pylogue-0.3.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pylogue
-Version: 0.2.1
+Version: 0.3.29
 Summary: A Chatbot UI built for AI agents
 Author-email: Yeshwanth Reddy <yyeshr@gmail.com>
 Maintainer-email: Yeshwanth Reddy <yyeshr@gmail.com>
@@ -20,6 +20,15 @@ Requires-Dist: mkdocs-minify-plugin>=0.8.0
 Requires-Dist: mkdocs-git-revision-date-localized-plugin>=1.4.7
 Requires-Dist: pymdown-extensions>=10.16.1
 Requires-Dist: python-fasthtml>=0.12.29
+Requires-Dist: monsterui
+Requires-Dist: logfire>=4.20.0
+Requires-Dist: pydantic-ai>=1.48.0
+Requires-Dist: fastsql>=2.1.2
+Requires-Dist: duckdb>=1.4.4
+Requires-Dist: altair>=6.0.0
+Requires-Dist: pandas>=3.0.0
+Requires-Dist: simple-salesforce>=1.12.9
+Requires-Dist: authlib>=1.3.2
 Provides-Extra: dev
 Requires-Dist: coverage; extra == "dev"
 Requires-Dist: mypy; extra == "dev"

pylogue-0.3.29/README.md

@@ -0,0 +1,117 @@
+# Pylogue
+
+A FastHTML‑first, streaming chat framework with enough structure to stay polite in production — and enough whimsy to keep the lights on.
+
+**Core promise:** You bring the agent. Pylogue handles the UI, streaming, and chat plumbing.
+
+## What It Is
+- **Core runtime** for streaming chat over WebSockets
+- **Responder integration** (e.g. Pydantic‑AI) with token streaming
+- **Composable UI** helpers for chat cards, input, markdown, and tool status
+- **Optional history** storage (local or SQLite via FastSQL)
+
+## Separation of Concerns (The USP)
+- **Your business:** build the agent + responder (what it should say).
+- **Pylogue’s business:** render the chat UI, stream tokens, and handle the wire protocol.
+
+## Quick Start (Minimal)
+```python
+from pylogue.core import main
+
+app = main(
+    responder=MyResponder(),
+    title="My Chat",
+    subtitle="Streaming chat with Pylogue",
+)
+```
+
+## Custom UI + Core WebSocket
+Build your own layout but keep core streaming behavior.
+```python
+from fasthtml.common import *
+from pylogue.core import get_core_headers, register_ws_routes, render_cards, render_input
+
+def app_factory():
+    app = FastHTML(exts="ws", hdrs=tuple(get_core_headers()), pico=False)
+    register_ws_routes(app, responder=MyResponder())
+
+    @app.route("/")
+    def home():
+        return Body(
+            Div(
+                Div(render_cards([])),
+                Form(
+                    render_input(),
+                    id="form",
+                    hx_ext="ws",
+                    ws_connect="/ws",
+                    ws_send=True,
+                    hx_target="#cards",
+                    hx_swap="outerHTML",
+                ),
+            )
+        )
+
+    return app
+```
+
+## Multi‑Chat Example (SQLite)
+See `scripts/examples/chat_app_with_histories/` for:
+- Sidebar history
+- Title editing
+- Delete with confirmation
+- SQLite persistence via FastSQL
+
+Run it:
+```bash
+python -m scripts.examples.chat_app_with_histories.main
+```
+
+## Architecture
+- **Flow diagram**: `docs/architecture.md`
+- **Integration manual**: `docs/pylogue_integration_manual.md`
+
+## Google Login (OAuth)
+Pylogue now supports opt-in Google login, modeled after the flow used in Vyasa.
+
+Set environment variables:
+```bash
+export PYLOGUE_GOOGLE_CLIENT_ID="your-google-client-id"
+export PYLOGUE_GOOGLE_CLIENT_SECRET="your-google-client-secret"
+export PYLOGUE_SESSION_SECRET="a-long-random-secret"
+```
+
+Optional allow-lists:
+```bash
+export PYLOGUE_GOOGLE_ALLOWED_DOMAINS="yourcompany.com"
+export PYLOGUE_GOOGLE_ALLOWED_EMAILS="alice@yourcompany.com,bob@yourcompany.com"
+```
+
+Optional auth toggle:
+```bash
+# defaults to true when Google OAuth is configured
+export PYLOGUE_AUTH_REQUIRED="true"
+```
+
+When enabled, Pylogue registers:
+- `/login`
+- `/login/google`
+- `/auth/google/callback`
+- `/logout`
+
+## How Streaming Works (Short Version)
+- Browser connects to `/ws`.
+- Core (`register_ws_routes`) streams chunks as they arrive.
+- Responder yields tokens; UI updates incrementally.
+
+## Folder Map
+- Core runtime: `src/pylogue/core.py`
+- Pydantic‑AI responder: `src/pylogue/integrations/pydantic_ai.py`
+- Multi‑chat app: `scripts/examples/chat_app_with_histories/`
+
+## Notes
+- If output appears all at once, your responder is not yielding chunks.
+- If WS doesn’t connect, check `ws_connect` path and `base_path`.
+
+## Contributing
+Professional, pragmatic, and a little whimsical. If you add a feature, add a small example.

{pylogue-0.2.1 → pylogue-0.3.29}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pylogue"
-version = "0.2.1"
+version = "0.3.29"
 description = "A Chatbot UI built for AI agents"
 readme = "README.rst"
 authors = [
@@ -27,6 +27,15 @@ dependencies = [
   "mkdocs-git-revision-date-localized-plugin>=1.4.7",
   "pymdown-extensions>=10.16.1",
   "python-fasthtml>=0.12.29",
+  "monsterui",
+  "logfire>=4.20.0",
+  "pydantic-ai>=1.48.0",
+  "fastsql>=2.1.2",
+  "duckdb>=1.4.4",
+  "altair>=6.0.0",
+  "pandas>=3.0.0",
+  "simple-salesforce>=1.12.9",
+  "authlib>=1.3.2",
 ]
 
 [project.optional-dependencies]
@@ -68,4 +77,3 @@ warn_no_return = true
 module = "tests.*"
 allow_untyped_defs = true
 disable_error_code = "attr-defined"
-