mdrideout · mdrideout · Feb 8, 2026 · Nov 22, 2025 · Nov 22, 2025 · Nov 22, 2025
diff --git a/.DS_Store b/.DS_Store
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -16,18 +16,12 @@ jobs:
       contents: read
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.x'
-
-      - name: Install protobuf compiler
-        run: pip install grpcio-tools
-
-      - name: Generate protobuf files
-        run: make proto
+          python-version: '3.11'
 
       - name: Build package
         run: |

diff --git a/.gitignore b/.gitignore
@@ -171,16 +171,16 @@ cython_debug/
 # PyPI configuration file
 .pypirc
 
-# Protobuf generated code
-# We commit these files to the repository to ensure that the package can be
-# installed directly from GitHub without requiring the user to have the
-# protobuf compiler installed.
-# src/junjo/telemetry/junjo_server/proto_gen/**.*
-
-# Keep the init
-# !src/junjo/telemetry/junjo_server/proto_gen/__init__.py
-
 # Misc
 .DS_Store
 .gitleaks/**
-graphviz_out
+graphviz_out
+
+# Coding Agents
+.claude
+# Viberag index
+.viberag/
+# MCP config (local, not committed)
+.cursor/mcp.json
+# MCP config (local, not committed)
+.zed/settings.json
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
diff --git a/.python-version b/.python-version
@@ -1 +1 @@
-3.13
+3.11
diff --git a/Makefile b/Makefile
diff --git a/README.md b/README.md
diff --git a/docs/_static/favicon.webp b/docs/_static/favicon.webp
diff --git a/docs/_static/subflow-junjo-server-visual.png → ...static/subflow-junjo-ai-studio-visual.png b/docs/_static/subflow-junjo-server-visual.png → ...static/subflow-junjo-ai-studio-visual.png
diff --git a/docs/_templates/sidebar/brand.html b/docs/_templates/sidebar/brand.html
@@ -0,0 +1,11 @@
+{% extends "furo/sidebar/brand.html" %}
+
+{% block brand_content %}
+  {# Check if a logo exists, if so, display it #}
+  {% if logo_url %}
+    <img class="sidebar-brand-image" src="{{ logo_url }}" alt="Logo"/>
+  {% endif %}
+
+  {# Use shorttitle if it exists, otherwise fallback to project or html_title #}
+  <span class="sidebar-brand-text">{{ shorttitle|default(project)|default(docstitle) }}</span>
+{% endblock %}
diff --git a/docs/api.rst b/docs/api.rst
@@ -1,10 +1,21 @@
 .. _api:
 
 API Reference
-=============
+============================
+
+Core API
+--------
 
 .. automodule:: junjo
    :members:
    :undoc-members:
    :show-inheritance:
 
+Telemetry API
+-------------
+
+.. automodule:: junjo.telemetry.junjo_otel_exporter
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
diff --git a/docs/concurrency.rst b/docs/concurrency.rst
@@ -59,13 +59,13 @@ When defining your workflow's graph or subflow, you can easily execute nodes and
 Example execution visualization:
 
 .. image:: _static/concurrent-visual.png
-   :alt: A screenshot of a Junjo workflow graph's telemetry on Junjo Server, featuring a RunConcurrent node in the workflow's graph.
+   :alt: A screenshot of a Junjo workflow graph's telemetry on Junjo AI Studio, featuring a RunConcurrent node in the workflow's graph.
    :align: center
    :width: 600px
 
 This example demonstrates how `RunConcurrent` can be utilized to execute nodes in parallel. You can also execute entire `Subflow` instances in parallel.
 
-All state updates made by these nodes are concurrency safe due to the immutable nature of state updates. **Junjo Server** allows you to step through state updates incrementally to see which nodes update state and when, even during high concurrency.
+All state updates made by these nodes are concurrency safe due to the immutable nature of state updates. **Junjo AI Studio** allows you to step through state updates incrementally to see which nodes update state and when, even during high concurrency.
 
 Immutable State: Ensuring Concurrency Safety
 ============================================

diff --git a/docs/conf.py b/docs/conf.py
@@ -25,7 +25,9 @@
 # -- Options for HTML output -------------------------------------------------
 
 html_theme = "furo"
-html_title = "Junjo Docs"
+html_favicon = "_static/favicon.webp"
+html_title = "Junjo AI Framework Python SDK Docs - API Reference | Junjo AI Studio"
+html_short_title = "Junjo Python Docs"
 html_baseurl = "https://python-api.junjo.ai/"
 
 # Hide the link to the rst source files
@@ -41,7 +43,7 @@
     #      "color-brand-primary": "orange",
     #     "color-brand-content": "#FF8800",
     # },
-    "sidebar_hide_name": False,  # Show the project name in the sidebar
+    "sidebar_hide_name": True,  # Show the project name in the sidebar
     # "navigation_with_keys": True, # Allow navigation with arrow keys
     # "announcement": "<em>Important</em> announcement!",  # Add a banner at the top
 }

diff --git a/docs/core_concepts.rst b/docs/core_concepts.rst
@@ -151,14 +151,18 @@ A `Workflow` is the main executable component that takes a `graph_factory` and a
         # ... (graph creation logic)
         return workflow_graph
 
-    sample_workflow = Workflow[MyWorkflowState, MyWorkflowStore](
-        name="My First Workflow",
-        graph_factory=create_graph,
-        store_factory=lambda: MyWorkflowStore(
-            initial_state=MyWorkflowState(user_input="hello")
+    def create_workflow() -> Workflow[MyWorkflowState, MyWorkflowStore]:
+        """Factory function to create a new instance of the workflow."""
+        return Workflow[MyWorkflowState, MyWorkflowStore](
+            name="My First Workflow",
+            graph_factory=create_graph,
+            store_factory=lambda: MyWorkflowStore(
+                initial_state=MyWorkflowState(user_input="hello")
+            )
         )
-    )
 
+    # Create and execute the workflow
+    sample_workflow = create_workflow()
     await sample_workflow.execute()
 
 **Passing Parameters to Factories**
@@ -179,14 +183,16 @@ concurrency safety.
         # ... setup graph using the api_key
         return Graph(...)
 
-    # Instantiate the workflow, using a lambda to create the factory
-    workflow = Workflow[MyState, MyStore](
-        name="configured_workflow",
-        graph_factory=lambda: create_graph_with_dependency(
-            api_key="your-secret-key"
-        ),
-        store_factory=lambda: MyStore(initial_state=MyState())
-    )
+    def create_workflow() -> Workflow[MyState, MyStore]:
+        # Instantiate the workflow, using a lambda to create the factory
+        return Workflow[MyState, MyStore](
+            name="configured_workflow",
+            graph_factory=lambda: create_graph_with_dependency(
+                api_key="your-secret-key"
+            ),
+            store_factory=lambda: MyStore(initial_state=MyState())
+        )
 
     # The workflow can now be executed normally
+    workflow = create_workflow()
     await workflow.execute()
diff --git a/docs/deployment.rst b/docs/deployment.rst
@@ -1,12 +1,12 @@
-Junjo Server Deployment
-=======================
+Junjo AI Studio Deployment
+===========================
 
-Junjo Server can be deployed in various ways depending on your needs. Being based on docker containers, it's easy to deploy Junjo Server anywhere with docker compose.
+Junjo AI Studio can be deployed in various ways depending on your needs. Being based on docker containers, it's easy to deploy Junjo AI Studio anywhere with docker compose.
 
-Bare-Bones Template (Recommended Starting Point)
--------------------------------------------------
+Minimal Build Template (Recommended Starting Point)
+------------------------------------------------------
 
-For a minimal, flexible Docker Compose setup that you can customize for your specific infrastructure needs, use the `Junjo Server Bare-Bones Template <https://github.com/mdrideout/junjo-server-bare-bones>`_.
+For a minimal, flexible Docker Compose setup that you can customize for your specific infrastructure needs, use the `Junjo AI Studio Minimal Build Template <https://github.com/mdrideout/junjo-ai-studio-minimal-build>`_.
 
 This GitHub template repository provides:
 
@@ -20,16 +20,16 @@ This GitHub template repository provides:
 - Teams with existing infrastructure
 - Custom deployment requirements
 - Local development environments
-- Learning Junjo Server architecture
+- Learning Junjo AI Studio architecture
 - Integration into existing docker-compose.yml files
 
 **Quick start:**
 
 .. code-block:: bash
 
     # Use as GitHub template or clone
-    git clone https://github.com/mdrideout/junjo-server-bare-bones.git
-    cd junjo-server-bare-bones
+    git clone https://github.com/mdrideout/junjo-ai-studio-minimal-build.git
+    cd junjo-ai-studio-minimal-build
 
     # Configure environment
     cp .env.example .env
@@ -44,16 +44,16 @@ This GitHub template repository provides:
 Digital Ocean VM Deployment Example
 ------------------------------------
 
-For a complete production junjo server deployment example to a fresh virtual machine using Docker Compose, Caddy reverse proxy, and automatic HTTPS, see the `Junjo Server Deployment Example <https://github.com/mdrideout/junjo-server-deployment-example>`_.
+For a complete production Junjo AI Studio deployment example to a fresh virtual machine using Docker Compose, Caddy reverse proxy, and automatic HTTPS, see the `Junjo AI Studio Deployment Example <https://github.com/mdrideout/junjo-ai-studio-deployment-example>`_.
 
 This example demonstrates:
 
 - **Low-cost VM setup** - Runs on a 1GB RAM VM with all services
 - **Microservices architecture** - Separate containers for:
 
-  - Junjo Server Ingestion (gRPC telemetry endpoint)
-  - Junjo Server Backend (API & authentication)
-  - Junjo Server Frontend (Web UI)
+  - Junjo AI Studio Ingestion (gRPC opentelemetry endpoint)
+  - Junjo AI Studio Backend (API & authentication)
+  - Junjo AI Studio Frontend (Web UI)
 
 - **Automatic HTTPS** - Caddy reverse proxy with Let's Encrypt SSL
 - **Subdomain routing** - Clean URLs for different services: