blaxel 0.1.22rc70__tar.gz → 0.2.0rc2__tar.gz

blaxel-0.2.0rc2/.github/workflows/dev.yaml

@@ -0,0 +1,42 @@
+name: Python SDK dev
+
+on:
+  workflow_dispatch:
+  push:
+    branches: ["develop"]
+
+jobs:
+  pypi-publish:
+    name: Upload blaxel package to PyPI (dev)
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      # For PyPI's trusted publishing.
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-tags: true
+          fetch-depth: 0
+      - name: "Install uv"
+        uses: astral-sh/setup-uv@v4
+      - name: Set version
+        run: |
+          VERSION=$(git describe --tags --abbrev=0)
+          VERSION="${VERSION#v}"
+          # Split version into parts and increment minor version
+          IFS='.' read -r major minor patch <<< "$VERSION"
+          patch=$((patch + 1))
+          VERSION="${major}.${minor}.${patch}"
+          echo "Current version: $VERSION"
+          sed -i -E "s/^version = .*/version = \"${VERSION}.pre-${{ github.run_number }}\"/" pyproject.toml
+      - name: Test package installation
+        run: |
+          uv venv
+          source .venv/bin/activate
+          uv pip install -e .
+          python -c "import blaxel.core; print('✅ blaxel package imports successfully')"
+      - name: Build and publish blaxel package
+        run: |
+          uv build
+          uv publish -v --trusted-publishing automatic dist/*

blaxel-0.2.0rc2/.github/workflows/prod.yaml

@@ -0,0 +1,34 @@
+name: Python SDK release
+
+on:
+  push:
+    tags:
+      - "*"
+
+jobs:
+  pypi-publish:
+    name: Upload blaxel package to PyPI
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: "Install uv"
+        uses: astral-sh/setup-uv@v4
+      - name: Set version
+        run: |
+          VERSION="${{ github.ref_name }}"
+          VERSION="${VERSION#v}"
+          echo "Setting version to $VERSION"
+          sed -i -E "s/^version = .*/version = \"${VERSION}\"/" pyproject.toml
+      - name: Test package installation
+        run: |
+          uv venv
+          source .venv/bin/activate
+          uv pip install -e .
+          python -c "import blaxel.core; print('✅ blaxel package imports successfully')"
+      - name: Build and publish blaxel package
+        run: |
+          uv build
+          uv publish -v --trusted-publishing automatic dist/*

blaxel-0.2.0rc2/.github/workflows/test.yaml

@@ -0,0 +1,52 @@
+name: Test blaxel package
+
+on:
+  pull_request:
+    branches: ["main", "develop"]
+  push:
+    branches: ["main", "develop"]
+
+jobs:
+  test:
+    name: Test blaxel package
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: "Install uv"
+        uses: astral-sh/setup-uv@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Test package installation (base)
+        run: |
+          uv venv
+          source .venv/bin/activate
+          uv pip install -e .
+          python -c "import blaxel.core; print('✅ blaxel.core imports successfully')"
+
+      - name: Test package installation (with extras)
+        run: |
+          source .venv/bin/activate
+          uv pip install -e ".[telemetry,crewai]"
+          python -c "
+          import blaxel.core
+          import blaxel.telemetry
+          import blaxel.crewai
+          print('✅ blaxel with extras imports successfully')
+          "
+
+      - name: Test package build
+        run: |
+          uv build
+          echo "✅ Package builds successfully"
+          ls -la dist/
+
+      - name: Run tests
+        run: |
+          source .venv/bin/activate
+          make test

blaxel-0.2.0rc2/.gitignore

@@ -0,0 +1,28 @@
+__pycache__/
+build/
+dist/
+*.egg-info/
+.pytest_cache/
+.ruff_cache
+# pyenv
+.python-version
+
+# Environments
+.env
+.venv
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# JetBrains
+.idea/
+
+/coverage.xml
+/.coverage
+uv.lock
+
+telemetry.sh
+definition.yml
+.DS_Store

blaxel-0.2.0rc2/.vscode/extensions.json

@@ -0,0 +1,6 @@
+{
+  "recommendations": [
+    "charliermarsh.ruff",
+    "ms-python.python"
+  ]
+}

blaxel-0.2.0rc2/.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+  "[python]": {
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+      "source.organizeImports": "explicit",
+      "source.fixAll": "explicit"
+    },
+    "editor.defaultFormatter": "charliermarsh.ruff"
+  },
+  "python.defaultInterpreterPath": "./.venv/bin/python",
+  "ruff.enable": true,
+  "ruff.organizeImports": true,
+  "ruff.fixAll": true,
+  "ruff.lint.enable": true,
+  "isort.args": [
+    "--profile",
+    "black"
+  ]
+}

blaxel-0.2.0rc2/Makefile

@@ -0,0 +1,60 @@
+ARGS:= $(wordlist 2,$(words $(MAKECMDGOALS)),$(MAKECMDGOALS))
+
+install:
+	uv sync --all-packages --all-extras --dev
+
+sdk-sandbox:
+	cp ../sandbox/sandbox-api/docs/openapi.yml ./definition.yml
+	rm -rf src/blaxel/core/sandbox/client/api src/blaxel/core/sandbox/client/models
+	openapi-python-client generate \
+		--path=definition.yml \
+		--output-path=./tmp-sdk-sandbox \
+		--overwrite \
+		--custom-template-path=./templates \
+		--config=./openapi-python-client.yml
+	cp -r ./tmp-sdk-sandbox/blaxel/* ./src/blaxel/core/sandbox/client
+	rm -rf ./tmp-sdk-sandbox
+	uv run ruff check --fix
+
+sdk-controlplane:
+	cp ../controlplane/api/api/definitions/controlplane.yml ./definition.yml
+	rm -rf src/blaxel/core/client/api src/blaxel/core/client/models
+	openapi-python-client generate \
+		--path=definition.yml \
+		--output-path=./tmp-sdk-python \
+		--overwrite \
+		--custom-template-path=./templates \
+		--config=./openapi-python-client.yml
+	cp -r ./tmp-sdk-python/blaxel/* ./src/blaxel/core/client
+	rm -rf ./tmp-sdk-python
+	uv run ruff check --fix
+
+sdk: sdk-sandbox sdk-controlplane
+
+doc:
+	rm -rf docs
+	uv run pdoc blaxel-docs src/* -o docs --force --skip-errors
+
+lint:
+	uv run ruff check --fix
+
+tag:
+	git tag -a v$(ARGS) -m "Release v$(ARGS)"
+	git push origin v$(ARGS)
+
+test: install-dev
+	uv run pytest tests/ -v
+
+test-with-telemetry:
+	uv sync --group test --extra telemetry
+	pip install -e .
+	uv run pytest tests/ -v
+
+install-dev:
+	uv sync --group test
+	pip install -e .
+
+%:
+	@:
+
+.PHONY: sdk

blaxel-0.2.0rc2/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: blaxel
+Version: 0.2.0rc2
+Summary: Blaxel - AI development platform SDK
+Project-URL: Homepage, https://blaxel.ai
+Project-URL: Documentation, https://docs.blaxel.ai
+Project-URL: Repository, https://github.com/blaxel-ai/sdk-python
+Project-URL: Changelog, https://docs.blaxel.ai/changelog
+Author-email: cploujoux <cploujoux@blaxel.ai>
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: attrs>=21.3.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp<=1.7.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyjwt>=2.0.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: requests>=2.32.3
+Requires-Dist: tomli>=2.2.1
+Requires-Dist: websockets<16.0.0
+Provides-Extra: all
+Requires-Dist: crewai>=0.120.1; extra == 'all'
+Requires-Dist: google-adk>=1.1.1; extra == 'all'
+Requires-Dist: langchain-anthropic>=0.3.10; extra == 'all'
+Requires-Dist: langchain-cerebras>=0.5.0; extra == 'all'
+Requires-Dist: langchain-cohere>=0.4.3; extra == 'all'
+Requires-Dist: langchain-community<0.4.0,>=0.3.3; extra == 'all'
+Requires-Dist: langchain-core<0.4.0,>=0.3.13; extra == 'all'
+Requires-Dist: langchain-deepseek-official>=0.1.0.post1; extra == 'all'
+Requires-Dist: langchain-openai>=0.3.10; extra == 'all'
+Requires-Dist: langchain-xai>=0.2.2; extra == 'all'
+Requires-Dist: langgraph<0.3.0,>=0.2.40; extra == 'all'
+Requires-Dist: litellm>=1.63.11; extra == 'all'
+Requires-Dist: livekit-agents[anthropic,cartesia,deepgram,elevenlabs,groq,openai,silero,turn-detector]~=1.0; extra == 'all'
+Requires-Dist: livekit-plugins-noise-cancellation~=0.2; extra == 'all'
+Requires-Dist: llama-index-llms-anthropic>=0.6.14; extra == 'all'
+Requires-Dist: llama-index-llms-cerebras>=0.2.2; extra == 'all'
+Requires-Dist: llama-index-llms-cohere>=0.4.1; extra == 'all'
+Requires-Dist: llama-index-llms-deepseek>=0.1.1; extra == 'all'
+Requires-Dist: llama-index-llms-google-genai>=0.1.13; extra == 'all'
+Requires-Dist: llama-index-llms-groq>=0.3.1; extra == 'all'
+Requires-Dist: llama-index-llms-mistralai>=0.4.0; extra == 'all'
+Requires-Dist: llama-index-llms-openai>=0.3.42; extra == 'all'
+Requires-Dist: llama-index>=0.12.37; extra == 'all'
+Requires-Dist: openai-agents>=0.0.14; extra == 'all'
+Requires-Dist: opentelemetry-exporter-otlp>=1.28.0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-anthropic==0.40.6; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-cohere==0.40.6; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-crewai>=0.40.6; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-fastapi==0.54b1; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-google-generativeai>=0.40.7; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-langchain>=0.35.0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-llamaindex>=0.40.7; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-ollama==0.40.6; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-openai==0.40.6; extra == 'all'
+Requires-Dist: pillow>=10.0.0; extra == 'all'
+Requires-Dist: pydantic-ai>=0.0.48; extra == 'all'
+Provides-Extra: core
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.120.1; extra == 'crewai'
+Requires-Dist: opentelemetry-instrumentation-crewai>=0.40.6; extra == 'crewai'
+Provides-Extra: dev
+Requires-Dist: pyright; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: uv; extra == 'dev'
+Provides-Extra: googleadk
+Requires-Dist: google-adk>=1.1.1; extra == 'googleadk'
+Requires-Dist: litellm>=1.63.11; extra == 'googleadk'
+Provides-Extra: langgraph
+Requires-Dist: langchain-anthropic>=0.3.10; extra == 'langgraph'
+Requires-Dist: langchain-cerebras>=0.5.0; extra == 'langgraph'
+Requires-Dist: langchain-cohere>=0.4.3; extra == 'langgraph'
+Requires-Dist: langchain-community<0.4.0,>=0.3.3; extra == 'langgraph'
+Requires-Dist: langchain-core<0.4.0,>=0.3.13; extra == 'langgraph'
+Requires-Dist: langchain-deepseek-official>=0.1.0.post1; extra == 'langgraph'
+Requires-Dist: langchain-openai>=0.3.10; extra == 'langgraph'
+Requires-Dist: langchain-xai>=0.2.2; extra == 'langgraph'
+Requires-Dist: langgraph<0.3.0,>=0.2.40; extra == 'langgraph'
+Requires-Dist: opentelemetry-instrumentation-langchain>=0.35.0; extra == 'langgraph'
+Requires-Dist: pillow>=10.0.0; extra == 'langgraph'
+Provides-Extra: livekit
+Requires-Dist: livekit-agents[anthropic,cartesia,deepgram,elevenlabs,groq,openai,silero,turn-detector]~=1.0; extra == 'livekit'
+Requires-Dist: livekit-plugins-noise-cancellation~=0.2; extra == 'livekit'
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-llms-anthropic>=0.6.14; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-cerebras>=0.2.2; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-cohere>=0.4.1; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-deepseek>=0.1.1; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-google-genai>=0.1.13; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-groq>=0.3.1; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-mistralai>=0.4.0; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-openai>=0.3.42; extra == 'llamaindex'
+Requires-Dist: llama-index>=0.12.37; extra == 'llamaindex'
+Requires-Dist: opentelemetry-instrumentation-llamaindex>=0.40.7; extra == 'llamaindex'
+Provides-Extra: openai
+Requires-Dist: openai-agents>=0.0.14; extra == 'openai'
+Provides-Extra: pydantic
+Requires-Dist: pydantic-ai>=0.0.48; extra == 'pydantic'
+Provides-Extra: telemetry
+Requires-Dist: opentelemetry-exporter-otlp>=1.28.0; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-anthropic==0.40.6; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-cohere==0.40.6; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-fastapi==0.54b1; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-google-generativeai>=0.40.7; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-ollama==0.40.6; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-openai==0.40.6; extra == 'telemetry'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://blaxel.ai/logo.png" alt="Blaxel" width=500/>
+</p>
+
+# Python SDK
+
+**Blaxel is a computing platform for AI agent builders, with all the services and infrastructure to build and deploy agents efficiently.** This repository contains the Python SDK to create and manage resources on Blaxel.
+
+## Table of Contents
+
+- [Installation](#installation)
+  - [Authentication](#authentication)
+- [Features](#features)
+- [Quickstart](#quickstart)
+- [Contributing](#contributing)
+- [License](#license)
+
+
+
+## Installation
+
+Install Blaxel SDK which lets you manage Blaxel resources.
+
+```bash
+# Base package (core functionality)
+pip install blaxel
+
+# With specific modules
+pip install "blaxel[telemetry]"
+pip install "blaxel[core,telemetry,crewai]"
+
+# Everything
+pip install "blaxel[all]"
+```
+
+### Available modules
+
+- `blaxel.core` - Core functionality (always available)
+- `blaxel.telemetry` - Telemetry and monitoring
+- `blaxel.crewai` - CrewAI integration
+- `blaxel.openai` - OpenAI integration
+- `blaxel.langgraph` - LangGraph integration
+- `blaxel.livekit` - LiveKit integration
+- `blaxel.llamaindex` - LlamaIndex integration
+- `blaxel.pydantic` - Pydantic AI integration
+- `blaxel.googleadk` - Google ADK integration
+
+
+
+### Authentication
+
+The Blaxel SDK authenticates with your workspace using credentials from these sources, in priority order:
+1. When running on Blaxel, authentication is handled automatically
+2. Variables in your .env file (`BL_WORKSPACE` and `BL_API_KEY`, or see [this page](https://docs.blaxel.ai/Agents/Variables-and-secrets) for other authentication options).
+3. Environment variables from your machine
+4. Configuration file created locally when you log in through Blaxel CLI (or deploy on Blaxel)
+
+When developing locally, the recommended method is to just log in to your workspace with Blaxel CLI. This allows you to run Blaxel SDK functions that will automatically connect to your workspace without additional setup. When you deploy on Blaxel, this connection persists automatically.
+
+When running Blaxel SDK from a remote server that is not Blaxel-hosted, we recommend using environment variables as described in the third option above.
+
+
+
+## Features
+- Agents & MCP servers
+  - [Create MCP servers](https://docs.blaxel.ai/Functions/Create-MCP-server)
+  - [Connect to MCP servers and model APIs hosted on Blaxel](https://docs.blaxel.ai/Agents/Develop-an-agent-ts)
+  - [Call agents from another agent](https://docs.blaxel.ai/Agents/Develop-an-agent-ts#connect-to-another-agent-multi-agent-chaining)
+  - [Deploy on Blaxel](https://docs.blaxel.ai/Agents/Deploy-an-agent)
+- Sandboxes
+  - [Create and update sandboxes and sandbox previews](https://docs.blaxel.ai/Sandboxes/Overview)
+  - [Run filesystem operations and processes on a sandbox](https://docs.blaxel.ai/Sandboxes/Processes)
+- [Use environment variables or secrets](https://docs.blaxel.ai/Agents/Variables-and-secrets)
+
+
+
+## Quickstart
+
+Blaxel CLI gives you a quick way to create new applications: agents, MCP servers, jobs, etc - and deploy them to Blaxel.
+
+**Prerequisites**:
+- **Node.js:** v18 or later.
+- **Blaxel CLI:** Make sure you have Blaxel CLI installed. If not, [install it](https://docs.blaxel.ai/cli-reference/introduction):
+  ```bash
+  curl -fsSL \
+  https://raw.githubusercontent.com/blaxel-ai/toolkit/main/install.sh \
+  | BINDIR=/usr/local/bin sudo -E sh
+  ```
+- **Blaxel login:** Login to Blaxel:
+  ```bash
+    bl login YOUR-WORKSPACE
+  ```
+
+```bash
+bl create-agent-app myfolder
+cd myfolder
+bl deploy
+```
+
+Also available:
+-  `bl create-mcp-server`
+-  `bl create-job`
+
+
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

blaxel-0.2.0rc2/README.md

@@ -0,0 +1,114 @@
+<p align="center">
+  <img src="https://blaxel.ai/logo.png" alt="Blaxel" width=500/>
+</p>
+
+# Python SDK
+
+**Blaxel is a computing platform for AI agent builders, with all the services and infrastructure to build and deploy agents efficiently.** This repository contains the Python SDK to create and manage resources on Blaxel.
+
+## Table of Contents
+
+- [Installation](#installation)
+  - [Authentication](#authentication)
+- [Features](#features)
+- [Quickstart](#quickstart)
+- [Contributing](#contributing)
+- [License](#license)
+
+
+
+## Installation
+
+Install Blaxel SDK which lets you manage Blaxel resources.
+
+```bash
+# Base package (core functionality)
+pip install blaxel
+
+# With specific modules
+pip install "blaxel[telemetry]"
+pip install "blaxel[core,telemetry,crewai]"
+
+# Everything
+pip install "blaxel[all]"
+```
+
+### Available modules
+
+- `blaxel.core` - Core functionality (always available)
+- `blaxel.telemetry` - Telemetry and monitoring
+- `blaxel.crewai` - CrewAI integration
+- `blaxel.openai` - OpenAI integration
+- `blaxel.langgraph` - LangGraph integration
+- `blaxel.livekit` - LiveKit integration
+- `blaxel.llamaindex` - LlamaIndex integration
+- `blaxel.pydantic` - Pydantic AI integration
+- `blaxel.googleadk` - Google ADK integration
+
+
+
+### Authentication
+
+The Blaxel SDK authenticates with your workspace using credentials from these sources, in priority order:
+1. When running on Blaxel, authentication is handled automatically
+2. Variables in your .env file (`BL_WORKSPACE` and `BL_API_KEY`, or see [this page](https://docs.blaxel.ai/Agents/Variables-and-secrets) for other authentication options).
+3. Environment variables from your machine
+4. Configuration file created locally when you log in through Blaxel CLI (or deploy on Blaxel)
+
+When developing locally, the recommended method is to just log in to your workspace with Blaxel CLI. This allows you to run Blaxel SDK functions that will automatically connect to your workspace without additional setup. When you deploy on Blaxel, this connection persists automatically.
+
+When running Blaxel SDK from a remote server that is not Blaxel-hosted, we recommend using environment variables as described in the third option above.
+
+
+
+## Features
+- Agents & MCP servers
+  - [Create MCP servers](https://docs.blaxel.ai/Functions/Create-MCP-server)
+  - [Connect to MCP servers and model APIs hosted on Blaxel](https://docs.blaxel.ai/Agents/Develop-an-agent-ts)
+  - [Call agents from another agent](https://docs.blaxel.ai/Agents/Develop-an-agent-ts#connect-to-another-agent-multi-agent-chaining)
+  - [Deploy on Blaxel](https://docs.blaxel.ai/Agents/Deploy-an-agent)
+- Sandboxes
+  - [Create and update sandboxes and sandbox previews](https://docs.blaxel.ai/Sandboxes/Overview)
+  - [Run filesystem operations and processes on a sandbox](https://docs.blaxel.ai/Sandboxes/Processes)
+- [Use environment variables or secrets](https://docs.blaxel.ai/Agents/Variables-and-secrets)
+
+
+
+## Quickstart
+
+Blaxel CLI gives you a quick way to create new applications: agents, MCP servers, jobs, etc - and deploy them to Blaxel.
+
+**Prerequisites**:
+- **Node.js:** v18 or later.
+- **Blaxel CLI:** Make sure you have Blaxel CLI installed. If not, [install it](https://docs.blaxel.ai/cli-reference/introduction):
+  ```bash
+  curl -fsSL \
+  https://raw.githubusercontent.com/blaxel-ai/toolkit/main/install.sh \
+  | BINDIR=/usr/local/bin sudo -E sh
+  ```
+- **Blaxel login:** Login to Blaxel:
+  ```bash
+    bl login YOUR-WORKSPACE
+  ```
+
+```bash
+bl create-agent-app myfolder
+cd myfolder
+bl deploy
+```
+
+Also available:
+-  `bl create-mcp-server`
+-  `bl create-job`
+
+
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

blaxel-0.2.0rc2/docs/blaxel/core/agents/index.md

@@ -0,0 +1,48 @@
+Module blaxel.core.agents
+=========================
+
+Functions
+---------
+
+`bl_agent(name: str)`
+:   
+
+`get_agent_metadata(name)`
+:   
+
+Classes
+-------
+
+`BlAgent(name: str)`
+:   
+
+    ### Instance variables
+
+    `external_url`
+    :
+
+    `fallback_url`
+    :
+
+    `forced_url`
+    :   Get the forced URL from environment variables if set.
+
+    `internal_url`
+    :   Get the internal URL for the agent using a hash of workspace and agent name.
+
+    `url`
+    :
+
+    ### Methods
+
+    `acall(self, url, input_data, headers: dict = {}, params: dict = {})`
+    :
+
+    `arun(self, input: Any, headers: dict = {}, params: dict = {}) ‑> Awaitable[str]`
+    :
+
+    `call(self, url, input_data, headers: dict = {}, params: dict = {})`
+    :
+
+    `run(self, input: Any, headers: dict = {}, params: dict = {}) ‑> str`
+    :

blaxel-0.2.0rc2/docs/blaxel/core/authentication/apikey.md

@@ -0,0 +1,43 @@
+Module blaxel.core.authentication.apikey
+========================================
+This module provides the ApiKey class, which handles API key-based authentication for Blaxel.
+
+Classes
+-------
+
+`ApiKey(credentials: blaxel.core.authentication.types.CredentialsType, workspace_name: str, base_url: str)`
+:   ApiKey auth that authenticates requests using an API key.
+    
+    Initializes the BlaxelAuth with the given credentials, workspace name, and base URL.
+    
+    Parameters:
+        credentials: Credentials containing the Bearer token and refresh token.
+        workspace_name (str): The name of the workspace.
+        base_url (str): The base URL for authentication.
+
+    ### Ancestors (in MRO)
+
+    * blaxel.core.authentication.types.BlaxelAuth
+    * httpx.Auth
+
+    ### Instance variables
+
+    `token`
+    :
+
+    ### Methods
+
+    `auth_flow(self, request: httpx.Request) ‑> Generator[httpx.Request, httpx.Response, None]`
+    :   Authenticates the request by adding API key and workspace headers.
+        
+        Parameters:
+            request (Request): The HTTP request to authenticate.
+        
+        Yields:
+            Request: The authenticated request.
+
+    `get_headers(self)`
+    :   Retrieves the authentication headers containing the API key and workspace information.
+        
+        Returns:
+            dict: A dictionary of headers with API key and workspace.