Polydesk

Polydesk is a conversational web agent for researching Polymarket markets.

The current version provides:

• A chat-bar-first conversation workspace with an always-available composer, a collapsed Session history drawer, and a tabbed right-side Market workspace.
• DeepSeek through pi-ai.
• A capability-neutral pi-agent-core loop with a Tool Registry, policy, direct runner, commands, artifacts, and SSE events.
• Natural-language market discovery.
• Deterministic /search <query>.
• Market results and tool state revealed progressively beside the conversation.
• Session and device-global saved-market lists with archive and restore controls.
• Worker-compatible public CLOB HTTP reads for selected-market Order Books and price history.
• Manual CLOB V2 limit-order review and submission inside a selected market card.
• A strict read-only Agent runtime: chat cannot place or cancel orders; trading uses a separate confirmation boundary.

Setup

Requires Node.js 22.13 or newer. From the project root:

npm --prefix web install

Set the ignored local values in web/.env.local:

DEEPSEEK_API_KEY=your-key
DEEPSEEK_MODEL=deepseek-v4-flash

Manual trading is opt-in. Copy the trading fields from web/.env.example into the ignored web/.env.local; at minimum configure the private key, signature type, and a local confirmation phrase. The default per-order safety limit is $100.

Preview

From the project root:

npm run preview

The development server listens on 0.0.0.0:3000 without running a production build first. Open http://<host-ip>:3000 from another machine.

Agents must not start Preview or run a production build unless explicitly requested.

Architecture

Web UI / SSE API
        ↓
Polydesk general harness, registry, policy, commands, and artifacts
        ↓
pi-agent-core inner loop + registered capabilities
        ↓
pi-ai DeepSeek boundary / Gamma + CLOB public and authenticated APIs

Browser Session snapshots and saved-market lists persist locally; the server-side Pi transcript and one-time order previews remain process-local. Cross-device sync, compaction, Agent-initiated transaction proposals, order management, and portfolio state are later milestones.

The detailed architecture website covers both the current implementation and the approved local Session/Memory design:

• Agent Architecture
• Sessions & Memory

To work on the documentation website:

python -m pip install -r requirements-docs.txt
npm run docs:preview

The configured public URL is https://pinktalk.online/polydesk-docs/.

Archived TUI

The previous Python/curses application is preserved only on the Git branch old-arch. Its source and runtime dependencies are intentionally absent from the active Web Agent branch.

The ignored root .env is retained locally for future migration work and is not loaded by the Web Agent.