Get Miko402 running locally in under 5 minutes. This guide covers cloning the repository, configuring your environment, and verifying the setup.
git clone https://github.com/Miko402-xyz/miko402.git
cd miko402
npm install
cp .env.example .env.local
# Add your OpenRouter API key to .env.local
npm run dev
Open http://localhost:3000 to access the application.
npm or yarn — Included with Node.js
Web3 Wallet — Phantom, MetaMask, or Coinbase Wallet
Some crypto — For testing payments (devnet works for free)
Modern browser — Chrome, Firefox, Brave, or Edge
Verify Your Environment
Step-by-Step Installation
1. Clone the Repository
2. Install Dependencies
This installs Next.js, React, Tailwind CSS, Solana Web3.js, the Vercel AI SDK, and all other required packages. Allow 2–3 minutes for completion.
Open .env.local and configure:
To obtain your OpenRouter API key:
Navigate to Keys → Create New Key
Copy the key into .env.local
Tip: Start with devnet for testing (free), then switch to mainnet when ready for production.
4. Start the Development Server
You should see:
5. Open in Browser
Visit http://localhost:3000. You should see the Miko402 landing page with the "Launch App" button.
Alternative Package Managers
Production Build
Production mode enables minification, tree-shaking, image optimization, and code splitting.
Solana RPC Configuration
Free Public RPCs
Premium RPC Providers
For production workloads, a dedicated RPC provider offers better reliability, higher rate limits, and faster response times.
Helius — helius.dev
QuickNode — quicknode.com
Alchemy — alchemy.com
Verify Installation
Test the Chat Interface
The chat interface should load
Send a test message (no wallet required for chat)
Miko should respond within seconds
Test Wallet Connection
Install Phantom or MetaMask
Click "Connect Wallet" in the application
Your wallet address should appear in the UI
Test a Payment (Optional)
Connect a wallet configured for devnet
Request a service: "Get weather data for San Francisco"
Approve the payment and observe the transaction flow
Port Already in Use
Module Not Found
API Key Not Working
Verify the key is correct in .env.local
Ensure there are no quotes around the value
Restart the dev server after making changes
Environment Variables Not Loading
The file must be named exactly .env.local
It must reside in the project root directory
Restart the dev server after any changes
Confirm .gitignore includes .env.local
Keep the dev server running during development — hot reload updates instantly
Never commit .env.local to version control
Use separate API keys for development and production
Rotate keys regularly as a security best practice
Use a premium RPC provider for production deployments
Installation complete? Continue to the Quick Start Guide to make your first autonomous payment.
Last updated
