BidPilot

BidPilot is a Swarms-powered bid analysis agent that turns RFPs, tenders, grants, procurement notices, and client briefs into go/no-go decisions, compliance checklists, proposal outlines, and executive summary drafts.

Features

• Paste-text opportunity analysis for RFPs, tenders, grants, procurement notices, client briefs, and freelance jobs.
• Server-side Swarms API integration through POST /api/analyze.
• Marketplace prompt mode through SWARMS_MARKETPLACE_PROMPT_ID.
• Local system prompt mode when a marketplace prompt ID is not configured.
• Structured report with bid-fit score, verdict, confidence, requirements, risks, missing information, proposal strategy, outline, executive summary, and next actions.
• Copy report and download as Markdown.
• Vercel-ready App Router architecture with no database, login, payment flow, or local file storage in V1.

Tech Stack

• Next.js App Router
• TypeScript
• React
• Tailwind CSS
• Zod
• Lucide React
• Vercel serverless API routes

Project Structure

bidpilot/
  app/
    api/analyze/route.ts
    globals.css
    layout.tsx
    page.tsx
  components/
  lib/
  public/
  types/

Environment Variables

Copy .env.example to .env.local for local development.

SWARMS_API_KEY=
SWARMS_MARKETPLACE_PROMPT_ID=
SWARMS_MODEL_NAME=gpt-4o-mini
SWARMS_AGENT_NAME=BidPilot
NEXT_PUBLIC_APP_NAME=BidPilot
NEXT_PUBLIC_TOKEN_TICKER=BIDBOT
NEXT_PUBLIC_TOKEN_ADDRESS=
NEXT_PUBLIC_SWARMS_MARKETPLACE_URL=

SWARMS_API_KEY is required for real analysis. Never commit .env.local, API keys, wallet private keys, or token-launch credentials.

Local Development

npm install
npm run dev

Open http://localhost:3000.

Before sharing or deploying:

npm run lint
npm run build

Swarms Setup

BidPilot calls:

POST https://api.swarms.world/v1/agent/completions

The API key is sent server-side through the x-api-key header. The browser never receives SWARMS_API_KEY.

Mode 1: Marketplace Prompt Mode

• Add your real marketplace prompt ID to SWARMS_MARKETPLACE_PROMPT_ID.
• BidPilot sends marketplace_prompt_id inside agent_config.
• The local system_prompt is not sent when a marketplace prompt ID exists.

Mode 2: Local System Prompt Mode

• Leave SWARMS_MARKETPLACE_PROMPT_ID empty.
• BidPilot uses lib/bidpilotPrompt.ts as the system prompt.

The current Swarms Agent API docs show the agent_config plus task request shape and x-api-key authentication. The Swarms Agent reference documents marketplace_prompt_id support for loading marketplace prompts.

Vercel Deployment

Create a Vercel project from this repository and add these environment variables in the Vercel dashboard:

• SWARMS_API_KEY
• SWARMS_MARKETPLACE_PROMPT_ID
• SWARMS_MODEL_NAME
• SWARMS_AGENT_NAME
• NEXT_PUBLIC_APP_NAME
• NEXT_PUBLIC_TOKEN_TICKER
• NEXT_PUBLIC_TOKEN_ADDRESS
• NEXT_PUBLIC_SWARMS_MARKETPLACE_URL

The API route uses the Node.js runtime and requires no local file writes, persistent backend server, or database.

GitHub Safety Checklist

Before pushing:

• Run npm install.
• Run npm run lint.
• Run npm run build.
• Confirm .env.local is ignored.
• Confirm no secrets appear in git diff.
• Confirm the README is complete.
• Confirm the app works locally.

Suggested first push commands after checks pass:

git init
git add .
git commit -m "Initial BidPilot production-ready build"
git branch -M main
git remote add origin <MY_REPO_URL>
git push -u origin main

Do not push until you have confirmed the repo URL and checks pass.

Mainnet/Frenzy Launch Notes

BidPilot is written with mainnet-ready wording only. It does not hardcode fake token addresses, fake marketplace URLs, fake transaction hashes, or simulated launch states.

Launch or tokenize the Swarms agent separately through the official Swarms launch/Frenzy flow. Do not put wallet private keys, seed phrases, token launch scripts, or privileged launch operations in this public Vercel frontend.

If a real token address exists, add it to NEXT_PUBLIC_TOKEN_ADDRESS so the footer can display it. If no token address exists yet, leave it blank.

Roadmap

• PDF upload
• DOCX upload
• Saved reports
• Supabase auth/history
• Team collaboration
• Proposal export to PDF
• Email report delivery
• Company capability profile
• Public tender URL analyzer

Disclaimer

BidPilot assists with bid strategy and proposal preparation. It does not guarantee contract awards, funding approval, legal compliance, procurement eligibility, token performance, or financial outcomes.