🔥 SolForge

AI-Powered Solana Development Suite 🤖⚡

The next-generation Solana development environment combining blazing-fast localnet performance with integrated AI assistance. Build faster, debug smarter, ship sooner.

---

🎯 What is SolForge?

SolForge started as a lightning-fast alternative to solana-test-validator, but has evolved into something far more powerful: a complete AI-powered Solana development suite that combines:

• 🚀 Ultra-Fast Localnet - Sub-second startup (~50MB vs 500MB+)
• 🤖 Integrated AI Assistant - Built-in coding assistant powered by Claude, GPT-4, or your choice of LLM
• 🎨 Modern Web Dashboard - Full-featured GUI with AI chat sidebar
• 🛠️ Complete Dev Toolkit - Program cloning, token minting, unlimited airdrops
• 🔌 Drop-in Compatible - Works with Anchor, web3.js, @solana/kit, and all existing tooling

Think of it as: Your localnet, your dev tools, and your AI pair programmer—all in one command.

---

✨ Why SolForge?

The All-in-One Development Suite

| Feature | SolForge | solana-test-validator | |---------|----------|----------------------| | Startup Time | < 1s | 10-30s | | Memory Usage | ~50MB | 500MB+ | | AI Assistant | ✅ Built-in | ❌ None | | Web Dashboard | ✅ Modern React UI | ❌ CLI only | | Program Cloning | ✅ One command | ❌ Manual | | Token Cloning | ✅ Automatic | ❌ Complex | | Unlimited Airdrops | ✅ Instant | ⚠️ Rate limited | | WebSocket Support | ✅ Real-time | ✅ Yes |

---

🚀 Quick Start

Installation

# One-liner install (recommended)
curl -fsSL https://install.solforge.sh | sh
Or with Bun
bun install -g solforge
Or with npm
npm install -g solforge

GitLab CI:

yaml script: - npm install -g solforge - solforge --ci & - sleep 5 - anchor test --skip-local-validator

Bind to all interfaces for LAN access

solforge --network

Note: Keep SolForge local-only in production for security

test = "anchor test --skip-local-validator"

Start SolForge

solforge

Start Everything

# Initialize config

This launches:

• 🌐 RPC Server: http://127.0.0.1:8899
• 📡 WebSocket: ws://127.0.0.1:8900
• 🎨 Web Dashboard: http://127.0.0.1:42069
• 🤖 AI Assistant: http://127.0.0.1:3456/ui (if enabled)

This runs interactive setup (first time) and launches all services:

Get Coding in 30 Seconds

# Configure Solana CLI
solana config set -u http://127.0.0.1:8899
Get some SOL
solana airdrop 1000
You're ready! 🎉

---

🤖 AI-Powered Development

Enable the AI Assistant

Add this to your sf.config.json:

{
  "agi": {
    "enabled": true
  }
}

That's it! The AI server starts automatically with smart defaults. No API keys required initially (uses AGI's defaults).

What Can the AI Do?

• 🐛 Debug Your Programs

"Why is my PDA derivation failing?"
   "Explain this transaction error: Program failed..."

• 📝 Generate Code

"Create an Anchor program for a token swap"
   "Write a TypeScript client for my NFT program"

• 🎓 Learn Solana

"What's the difference between a PDA and a keypair?"
   "How do cross-program invocations work?"

• 🔍 Review & Optimize

"Review this program for security issues"
   "How can I optimize these compute units?"

• 🚀 Deployment Help

"Deploy this program to devnet"
   "Set up CI/CD for my Anchor project"

Access the AI

• Web Dashboard: Built-in chat sidebar at http://127.0.0.1:42069
• Standalone UI: Direct access at http://127.0.0.1:3456/ui
• API: Programmatic access via REST/SSE endpoints

📖 Detailed Guide: AGI_QUICKSTART.md

---

🎨 Web Dashboard

The modern web interface combines all your dev tools in one place:

Features

• 📊 Real-time Monitoring - Slots, blocks, transactions
• 💸 Instant Airdrops - Visual SOL distribution
• 🪙 Token Management - Create, clone, and mint tokens
• 🤖 AI Chat Sidebar - Get help without leaving your workspace
• 🔍 Transaction Inspector - Debug transactions visually
• 📈 Network Stats - Live performance metrics

Access at http://127.0.0.1:42069 when SolForge is running.

---

🛠️ Complete Development Toolkit

Program Development

# Clone programs from mainnet
solforge program clone TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
Clone with all associated accounts
solforge program clone <PROGRAM_ID> --with-accounts
Load your own program
solforge program load --file ./target/deploy/my_program.so

Token Operations

# Clone USDC to localnet
solforge token clone EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Create new token with metadata
solforge mint
Interactive token creation wizard
solforge token create

Instant Airdrops

# No rate limits, no waiting
solforge airdrop --to <PUBKEY> --sol 1000
Or use the web dashboard for visual control

---

📝 Configuration

Create sf.config.json to customize everything:

{
  "name": "my-solana-project",
  "server": {
    "rpcPort": 8899,
    "wsPort": 8900
  },
  "gui": {
    "enabled": true,
    "port": 42069
  },
  "agi": {
    "enabled": true,
    "port": 3456,
    "provider": "openrouter",
    "model": "anthropic/claude-3.5-sonnet"
  },
  "clone": {
    "programs": [
      "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
    ],
    "tokens": [
      {
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "USDC"
      }
    ]
  },
  "bootstrap": {
    "airdrops": [
      {
        "address": "YOURWALLETADDRESS",
        "amountSol": 100
      }
    ]
  }
}

Configuration Options

| Section | Purpose | Docs | |---------|---------|------| | server | RPC/WebSocket ports | docs/CONFIGURATION.md | | gui | Web dashboard settings | apps/web/README.md | | agi | AI assistant configuration | AGI_QUICKSTART.md | | clone | Auto-clone programs/tokens | docs/CONFIGURATION.md | | bootstrap | Auto-airdrops on startup | docs/CONFIGURATION.md |

---

🔌 Framework Integration

Anchor

# Anchor.toml
[provider]
cluster = "http://127.0.0.1:8899"
wallet = "~/.config/solana/id.json"
[scripts] test = "solforge &&  anchor test --skip-local-validator"

@solana/web3.js

import { Connection, PublicKey, LAMPORTSPERSOL } from "@solana/web3.js";
const connection = new Connection("http://127.0.0.1:8899", "confirmed");
// Request airdrop await connection.requestAirdrop(   new PublicKey("YOUR_WALLET"),   100 * LAMPORTSPERSOL );
// Get balance const balance = await connection.getBalance(publicKey);

@solana/kit (Recommended)

import { createSolanaRpc } from "@solana/kit";
import { address, lamports } from "@solana/web3.js";
const rpc = createSolanaRpc("http://127.0.0.1:8899");
// Request airdrop await rpc   .requestAirdrop(address("YOURWALLET"), lamports(100000000000n))   .send();
// Get balance const balance = await rpc.getBalance(address("YOUR_WALLET")).send();

---

📊 Performance & Comparison

Speed Matters

# solana-test-validator
$ time solana-test-validator
$ time solforge
Startup: ~15-30 seconds
Memory: 500-800 MB
CPU: 5-10% idle
$ time solforge
SolForge
$ time solforge
Startup: < 1 second
Memory: ~50 MB
CPU: < 1% idle

Why It's Fast

• LiteSVM: Built on an optimized Solana Virtual Machine implementation
• Minimal Overhead: No unnecessary validators or consensus
• Efficient Architecture: Bun runtime + smart resource management
• Optimized RPC: Direct SVM access without validator overhead

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                        SolForge CLI                          │
│  Entry point - orchestrates all components                  │
└───────────┬─────────────────────────────────────────────────┘
            │
            ├──> 🚀 LiteSVM RPC Server (packages/server)
            │    • Full Solana RPC API (90+ methods)
            │    • WebSocket subscriptions
            │    • ~50MB memory, sub-second startup
            │
            ├──> 🎨 Web Dashboard (apps/web)
            │    • React + TypeScript + Vite
            │    • Real-time monitoring
            │    • Token & airdrop tools
            │    • AGI chat sidebar integration
            │
            └──> 🤖 AGI Server (@agi-cli/server)
                 • Embedded AI assistant
                 • Multi-provider support (OpenRouter, Anthropic, OpenAI)
                 • Specialized Solana development agents
                 • REST API + SSE streaming

Project Structure

solforge/
├── apps/
│   ├── cli/              # Main CLI entry point
│   │   ├── commands/     # start, init, mint, etc.
│   │   ├── services/     # Process management, token cloning
│   │   └── config/       # Configuration management
│   └── web/              # React dashboard
│       ├── components/   # UI components + AGI sidebar
│       └── routes/       # Dashboard pages
├── packages/
│   ├── server/           # LiteSVM RPC/WebSocket server
│   │   ├── methods/      # 90+ RPC method implementations
│   │   └── ws-server/    # WebSocket subscription server
│   └── install/          # Installation CLI
└── docs/                 # Architecture & guides

---

🎓 Use Cases

For Hackathons 🏆

• Fast Iteration: Sub-second restart means rapid development
• AI Pair Programming: Debug faster with integrated AI
• Complete Toolkit: Everything you need in one tool
• Visual Debugging: Web dashboard for real-time insights

For Learning 📚

• Beginner Friendly: AI explains Solana concepts as you code
• Interactive: Web GUI makes concepts visual
• Fast Feedback: Instant airdrops and program deployment
• Production-Ready: Same RPC API as mainnet

For Teams 👥

• Consistent Environments: Same config across all devs
• Faster Onboarding: One command to start developing
• AI Knowledge Base: Team can query AI for project patterns
• Remote Development: --network flag for LAN access

For CI/CD 🔄

• Fast Tests: Startup time doesn't bottleneck pipelines
• Scriptable: Full CLI automation support
• Docker Ready: Minimal resource footprint
• Reliable: Deterministic behavior for testing

---

📚 Documentation

📖 Complete Documentation - All documentation is now hosted on the website as a single source of truth.

Quick links:

• AI Assistant Setup - Enable and configure the AI
• Configuration Reference - Complete sf.config.json guide
• CLI Commands - All available CLI commands

---

🔧 Advanced Usage

AI Configuration

{
  "agi": {
    "enabled": true,
    "port": 3456,
    "provider": "openrouter",
    "model": "anthropic/claude-3.5-sonnet",
    "agent": "general"
  }
}

Supported Providers:

• OpenRouter (recommended - access to all models with one key)
• Anthropic (Claude 3.5 Sonnet)
• OpenAI (GPT-4 Turbo)

Agent Types:

• general - General Solana development & debugging
• build - Build processes & deployment tasks

Network Mode

Make your localnet accessible on your LAN:

solforge --network

Now accessible at http://YOUR_IP:8899 from other devices.

Bootstrap Configurations

Auto-setup on every start:

{
  "clone": {
    "programs": ["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"],
    "tokens": [
      {
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "USDC"
      }
    ]
  },
  "bootstrap": {
    "airdrops": [
      { "address": "YOUR_WALLET", "amountSol": 100 }
    ]
  }
}
    steps:
      - uses: actions/checkout@v4
      - run: npm install -g solforge
      - run: solforge --ci &
      - run: sleep 5 && anchor test --skip-local-validator

run: |

• name: Run Tests

run: | anchor test --skip-local-validator

---
🏗️ Building from Source
Prerequisites
Bun runtime

Build Commands

bash

Clone & install

git clone https://github.com/nitishxyz/solforge.git cd solforge bun install

Run from source

bun apps/cli/index.ts start

Build binary for your platform

bun run --filter @solforge/cli build:bin

Build for all platforms

bun run --filter @solforge/cli build:bin:all

### Platform-Specific Builds

bash

macOS (Apple Silicon)

bun run build:bin:darwin-arm64

macOS (Intel)

bun run build:bin:darwin-x64

Linux x64

bun run build:bin:linux-x64

Linux ARM64

bun run build:bin:linux-arm64

Windows x64

bun run build:bin:windows-x64

---
🔍 Troubleshooting
Port Already in Use

bash

Check what's using the port

lsof -i :8899

Use different port

solforge --port 9999

### AI Server Not Starting

bash

Check API key (if using specific provider)

echo $OPENROUTERAPIKEY

Start with debug logs

solforge --debug

Use minimal config (no API key needed)

{ "agi": { "enabled": true } }

### GUI Not Loading

bash

Check if port is available

lsof -i :42069

Use different port

export SOLFORGEGUIPORT=3000 solforge

### Connection Refused
Quick Reference

bash solforge # Start everything solforge stop # Stop everything solforge mint # Mint tokens solforge token clone # Clone token from mainnet

---
📚 API Coverage
✅ Fully Implemented (90+ methods)
Account Operations: getAccountInfo, getMultipleAccounts, getProgramAccounts
Transaction Processing: sendTransaction, simulateTransaction, getTransaction
Block & Slot Queries: getBlock, getSlot, getBlockHeight, getEpochInfo
Token Operations: getTokenAccountsByOwner, getTokenSupply, getTokenAccountBalance
Program Deployment: Full program deployment support
WebSocket Subscriptions: accountSubscribe, signatureSubscribe, programSubscribe

🚧 In Progress
Additional WebSocket subscription types
Stake account operations
Vote account queries

📋 Planned
Snapshot/restore functionality
Time-travel debugging
Multi-tenant support
Enhanced transaction inspection


🤝 Contributing
We welcome contributions! Whether you're: 
Adding new RPC methods
 
Improving AI prompts
 
Enhancing the web dashboard
 
Writing documentation
 
Reporting bugs
 
 See AGENTS.md for development guidelines.

Development Workflow

bash

Run tests

bun test

Lint code

bun run lint

Format code

bun run format ```

---

🙏 Acknowledgments

SolForge is built on the shoulders of giants:

• LiteSVM - Fast Solana VM implementation
• Bun - Lightning-fast JavaScript runtime
• @agi-cli - AI coding assistant framework
• Solana Labs - For building an incredible blockchain platform
• The Solana Community - For inspiration and feedback

---

📄 License

MIT License - see LICENSE for details.

---

🔗 Links

• GitHub: github.com/nitishxyz/solforge
• Issues: Report bugs or request features
• Discord: Join our community (coming soon)
• Twitter: @solforgedev (coming soon)_

---

🌟 Star History

If SolForge helps you build faster, please consider starring the repo! ⭐

---

Made with ❤️ for Solana developers
From a simple localnet to an AI-powered development suite

Get Started • AI Docs • Full Docs • Support