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

TEXT
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.

BASH
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

BASH
npm install  
npm run dev  

Open http://localhost:3000.

Before sharing or deploying:

BASH
npm run lint  
npm run build  

Swarms Setup

BidPilot calls:

TEXT
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:

BASH
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.

Source: https://github.com/deamybro/Bidpilot