cowork-dash 0.1.2__py3-none-any.whl

cowork_dash-0.1.2.dist-info/METADATA

@@ -0,0 +1,238 @@
+Metadata-Version: 2.4
+Name: cowork-dash
+Version: 0.1.2
+Summary: AI Agent Web Interface with Filesystem and Canvas Visualization
+Project-URL: Homepage, https://github.com/dkedar7/cowork-dash
+Project-URL: Documentation, https://github.com/dkedar7/cowork-dash/blob/main/README.md
+Project-URL: Repository, https://github.com/dkedar7/cowork-dash
+Project-URL: Bug Tracker, https://github.com/dkedar7/cowork-dash/issues
+Author-email: Kedar Dabhadkar <kdabhadk@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,cowork,dash,dashboard,plotly,visualization
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.11
+Requires-Dist: dash-iconify>=0.1.2
+Requires-Dist: dash-mantine-components>=0.14.0
+Requires-Dist: dash>=2.0.0
+Requires-Dist: deepagents>=0.1.0
+Requires-Dist: matplotlib>=3.5.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: pillow>=9.0.0
+Requires-Dist: plotly>=5.0.0
+Requires-Dist: python-dotenv>=0.19.0
+Provides-Extra: all
+Requires-Dist: black>=22.0.0; extra == 'all'
+Requires-Dist: flake8>=4.0.0; extra == 'all'
+Requires-Dist: ipython>=8.0.0; extra == 'all'
+Requires-Dist: mypy>=0.950; extra == 'all'
+Requires-Dist: pytest-cov>=3.0.0; extra == 'all'
+Requires-Dist: pytest>=7.0.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: black>=22.0.0; extra == 'dev'
+Requires-Dist: flake8>=4.0.0; extra == 'dev'
+Requires-Dist: mypy>=0.950; extra == 'dev'
+Requires-Dist: pytest-cov>=3.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Provides-Extra: ipython
+Requires-Dist: ipython>=8.0.0; extra == 'ipython'
+Description-Content-Type: text/markdown
+
+# Cowork Dash
+
+A web interface for AI agent interactions with filesystem workspace, canvas visualization, and real-time streaming.
+
+## Features
+
+- **AI Agent Chat**: Real-time streaming with thinking process and task progress
+- **File Browser**: Interactive file tree with lazy loading
+- **Canvas**: Visualize DataFrames, Plotly/Matplotlib charts, Mermaid diagrams, images
+- **Flexible Configuration**: Environment variables, CLI args, or config file
+
+## Quick Start
+
+### Installation
+
+```bash
+# Install via pip (includes DeepAgents)
+pip install cowork-dash
+
+# Or run directly with uvx (no installation needed)
+export ANTHROPIC_API_KEY="your_anthropic_api_key"
+uvx cowork-dash run --workspace ~/my-workspace
+```
+
+### Run
+After setting up your agent (optional), run the app.
+You can also use the default agent by setting ANTHROPIC_API_KEY environment variable.
+
+```bash
+# Run with defaults (current directory as workspace, no agent)
+export ANTHROPIC_API_KEY="your_anthropic_api_key"
+cowork-dash run
+
+# Run with workspace
+cowork-dash run --workspace ~/my-workspace
+
+# Run with custom agent (optional)
+cowork-dash run --agent my_agent.py:agent
+
+# Using uvx (one-off execution)
+uvx cowork-dash run --workspace ~/my-workspace --port 8080
+```
+
+Open browser to `http://localhost:8050`
+
+## Configuration
+
+### Priority (highest to lowest)
+
+1. **CLI Arguments** - `--workspace`, `--port`, etc.
+2. **Environment Variables** - `DEEPAGENT_*`
+3. **Config File** - `config.py` defaults
+
+### Environment Variables (optional)
+
+```bash
+export DEEPAGENT_SPEC=my_agent.py:agent         # Set any Langgraph agent
+export DEEPAGENT_WORKSPACE_ROOT=/path/to/workspace
+export DEEPAGENT_PORT=9000                      # optional (default: 8050)
+export DEEPAGENT_HOST=0.0.0.0                   # optional (default: localhost)
+export DEEPAGENT_DEBUG=true                     # optional (default: false)
+export DEEPAGENT_APP_TITLE="My App"             # optional
+export DEEPAGENT_APP_SUBTITLE="Subtitle"        # optional
+
+cowork-dash run
+```
+
+### CLI Options (all optional)
+
+```bash
+cowork-dash run [OPTIONS]
+
+  --workspace PATH        Workspace directory (default: current directory)
+  --agent PATH:OBJECT     Agent spec (default: none, manual mode)
+  --port PORT            Server port (default: 8050)
+  --host HOST            Server host (default: localhost)
+  --debug                Enable debug mode
+  --title TITLE          App title (default: "Cowork Dash")
+  --subtitle TEXT        App subtitle (default: "AI-Powered Workspace")
+```
+
+### Python API
+
+```python
+from cowork_dash import run_app
+
+# Option 1: Pass agent instance directly (recommended)
+from my_agent import MyAgent
+agent = MyAgent()
+run_app(agent, workspace="~/my-workspace")
+
+# Option 2: Use agent spec
+run_app(agent_spec="my_agent.py:agent", workspace="~/my-workspace")
+
+# Option 3: Manual mode (no agent)
+run_app(workspace="~/my-workspace", port=8080, debug=True)
+```
+
+## Agent Integration
+
+### Workspace Access
+
+Cowork Dash sets `DEEPAGENT_WORKSPACE_ROOT` environment variable for your agent:
+
+```python
+import os
+from pathlib import Path
+
+# In your agent code
+workspace = Path(os.getenv('DEEPAGENT_WORKSPACE_ROOT', './'))
+
+# Read/write files in workspace
+config_file = workspace / "config.json"
+```
+
+### Agent Specification
+
+Load agents using `path:object` format:
+
+```bash
+# Load from Python file
+cowork-dash run --agent agent.py:my_agent
+
+# Absolute path
+cowork-dash run --agent /path/to/agent.py:agent_instance
+```
+
+### Agent Requirements
+
+Your agent must implement:
+- **Streaming**: `agent.stream(input, stream_mode="updates")`
+- **Message format**: `{"messages": [{"role": "user", "content": "..."}]}`
+- **Workspace access** (optional): Read `DEEPAGENT_WORKSPACE_ROOT` env var
+
+### Example Agent Setup
+
+```python
+# my_agent.py
+import os
+from deepagents import create_deep_agent
+from deepagents.backends.filesystem import FileSystemBackend
+
+backend = FileSystemBackend(root=os.getenv('DEEPAGENT_WORKSPACE_ROOT', './'))
+my_agent = create_deep_agent(..., backend=backend)
+```
+
+Then run: `cowork-dash run --agent my_agent.py:my_agent`
+
+## Canvas
+
+The canvas displays agent-created visualizations:
+
+- **DataFrames**: HTML tables
+- **Charts**: Plotly, Matplotlib
+- **Images**: PNG, JPG, etc.
+- **Diagrams**: Mermaid (flowcharts, sequence diagrams)
+- **Markdown**: Text and notes
+
+Content auto-saves to `canvas.md` and can be exported or cleared.
+
+## Development
+
+```bash
+# Install from source
+git clone https://github.com/dkedar7/cowork-dash.git
+cd cowork-dash
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Build package
+python -m build
+```
+
+## Requirements
+
+- Python 3.11+
+- Dash 2.0+
+- dash-mantine-components
+- pandas, plotly, matplotlib, Pillow
+- python-dotenv
+- deepagents
+
+## Links
+
+- **PyPI**: https://pypi.org/project/cowork-dash/
+- **GitHub**: https://github.com/dkedar7/cowork-dash
+- **Issues**: https://github.com/dkedar7/cowork-dash/issues

cowork_dash-0.1.2.dist-info/RECORD

@@ -0,0 +1,19 @@
+cowork_dash/__init__.py,sha256=37qBKl7g12Zos8GFukXLXligCdpD32e2qe9F8cd8Qdk,896
+cowork_dash/__main__.py,sha256=CCM9VIkWuwh7hwVGNBBgCCbeVAcHj1soyBVXUaPgABk,131
+cowork_dash/agent.py,sha256=dj50jBzP69YgEzEF44IeE8p11X0ap3xKwdITORnpkhs,4318
+cowork_dash/app.py,sha256=GaP9nZVKG5SECAMmaIw5ffJQTZAo1-s-FPNm7hlq06Y,68956
+cowork_dash/canvas.py,sha256=9X_Z6gOwFwIfBk8rsXi4s1hpKAyaK6wglgZ_1UGjZ3E,11093
+cowork_dash/cli.py,sha256=N9APQlQ-5oahUxMoICpJV1FcmVOFNmJpCfaULDeYhRY,6491
+cowork_dash/components.py,sha256=VDJ_IQ8qW7O3dAMVoz97yzBByRBC7XvpnVmDMCIlEUY,20538
+cowork_dash/config.py,sha256=WaFTvbrDPrK2SMvcmOBYXvt1Zc1my3F2dgnym2nsg2k,3008
+cowork_dash/file_utils.py,sha256=s2-L5wFOE-ChpKaZQwdRUSx5qA96ATR1QtmpkrJXUJY,8542
+cowork_dash/layout.py,sha256=1L5XcWEBao1mk3uWqeu6dD4Bos4V-ulxpkgVTFLyQSM,11250
+cowork_dash/tools.py,sha256=6WYK9-s32R5PfZvcpBIR55Z0I6wBgrxJvcxcgfnQ54E,23125
+cowork_dash/assets/app.js,sha256=CIRhskgTn4zPJGfubTYvsZFYSj-0XJNniGlSggy75L4,8162
+cowork_dash/assets/favicon.svg,sha256=MdT50APCvIlWh3HSwW5SNXYWB3q_wKfuLP-JV53SnKg,1065
+cowork_dash/assets/styles.css,sha256=ZiWpULBDO64Hu6bZ5NYFbzDfQ8Ezn66eKjW1LpJ8anM,20621
+cowork_dash-0.1.2.dist-info/METADATA,sha256=-rx1rPPJx600RQrCp0cuuZMjvX29jWoflW2nJ8Pref4,6959
+cowork_dash-0.1.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cowork_dash-0.1.2.dist-info/entry_points.txt,sha256=lL_9XJINiky3nh13tLqWd61LitKbbyh085ROATH9fck,53
+cowork_dash-0.1.2.dist-info/licenses/LICENSE,sha256=2SFXFfIa_c_g_uwY0JApQDXI1mWqEfJeG87Pn4ehLMQ,1072
+cowork_dash-0.1.2.dist-info/RECORD,,

cowork_dash-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

cowork_dash-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cowork-dash = cowork_dash.cli:main

cowork_dash-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Kedar Dabhadkar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.