Web3GPT

August 18, 2026 ยท View on GitHub

Web3GPT is an AI-powered smart contract platform for chatting with onchain agents, deploying Solidity contracts, and running agent-driven workflows on EVM chains.

The current public integration surface is agent-first:

  • browser chat UI at w3gpt.ai
  • skill endpoint at https://w3gpt.ai/api/skill
  • skill guide at https://w3gpt.ai/skill.md
  • API reference at https://w3gpt.ai/api-docs

What Changed

  • the old Unkey-backed /api/v1 endpoints are removed
  • the SDK now targets the skill/chat flow instead of separate completions/deploy APIs
  • Polygon mainnet deployment is available through the agent and skill endpoint
  • Polygon mainnet is not exposed through wallet connectors in the UI

Core Flows

  • chat with built-in or user-created Web3GPT agents
  • deploy contracts through the agent conversation
  • persist authenticated browser chats in Vercel KV
  • persist anonymous skill chats by chatId
  • verify deployments through the Vercel cron job

Supported Agent Deployment Chains

  • Polygon Mainnet
  • Polygon Amoy
  • Base Sepolia
  • Arbitrum Sepolia
  • Optimism Sepolia
  • Mantle Sepolia
  • Metis Sepolia
  • Celo Alfajores
  • Ethereum Sepolia

Getting Started

  1. Clone the repository.
  2. Copy .env.example and fill in the required variables.
  3. Install dependencies.
  4. Run the app.
bun install
bun dev

Local Sign-In

Create a GitHub OAuth app with the callback URL http://localhost:3000/api/auth/callback/github, then set AUTH_GITHUB_ID, AUTH_GITHUB_SECRET and AUTH_SECRET in .env.local. Sign-in works locally with no further configuration.

Important Environment Variables

  • OPENAI_API_KEY
  • DEPLOYER_PRIVATE_KEY
  • AUTH_GITHUB_ID
  • AUTH_GITHUB_SECRET
  • AUTH_SECRET
  • CRON_SECRET
  • KV_REST_API_URL
  • KV_REST_API_TOKEN
  • NEXT_PUBLIC_ALCHEMY_API_KEY
  • NEXT_PUBLIC_TENDERLY_API_KEY
  • NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID
  • ETHERSCAN_API_KEY
  • BLOCKSCOUT_API_KEY
  • PINATA_JWT

Skill API

Start a chat:

curl https://w3gpt.ai/api/skill

Continue a chat:

curl -X POST "https://w3gpt.ai/api/skill?chatId=your-chat-id" \
  -H "Content-Type: application/json" \
  -d '{"message":"Deploy an ERC20 on Polygon mainnet"}'

Include full history:

curl "https://w3gpt.ai/api/skill?chatId=your-chat-id&history=true"

The chatId is the secret for continuing a thread outside the browser UI.

Development Commands

  • bun dev
  • bun run build
  • bun run start
  • bun run typecheck
  • bun run lint
  • bun run format