nano-cowork

Minimal Claude cowork, AI coworking assistant with a web UI. Single Python file, one dependency (streamlit), powered by OpenRouter.

Built with Claude, then used to build itself.

Features

• Full agentic loop with tool use (up to 10 steps)
• Tools: list_files, read_file, write_file, run_command, preview_artifact
• Live preview panel for HTML/Markdown files
• File upload and workspace browser
• Works with any model via OpenRouter
• Zero SDK dependencies — raw HTTP requests to the API

Usage

pip install streamlit
export OPENROUTER_API_KEY="your-key"
streamlit run nano_cowork.py

The default model is anthropic/claude-opus-4.5. You can change it in the sidebar.

Tools

Tool	Description
list_files	List files in workspace directory
read_file	Read file contents
write_file	Write/create files
run_command	Run shell commands (30s timeout)
preview_artifact	Render a file in the preview panel (HTML or Markdown)

UI Layout

• Left — Chat with the agent
• Right — Live preview panel (appears when a file is previewed)
• Sidebar — API key, model, system prompt, workspace browser, file upload

Example

You: Create an index.html with a simple landing page

⚙️ Step 1: Working...
  Action: write_file
  Result: Wrote index.html

⚙️ Step 2: Working...
  Action: preview_artifact
  Result: Displayed in preview panel.

Created a landing page and opened it in the preview panel.

License

Apache 2.0 License. See LICENSE.