PAME CLI - AI Operating System

The official CLI for PAME - Build enterprise AI applications with 34 integrated tools.

🚀 Installation

npm install -g pameai
# or
yarn global add pameai
# or
pnpm add -g pameai
# or
bun add -g pameai

🎉 First-Time Experience

When you run pame for the first time, you'll be greeted with a delightful onboarding experience:

1. Beautiful Welcome: Animated intro with gradient text and progressive feature reveal
2. Personal Introduction: We'll ask for your name to personalize the experience
3. Feature Showcase: See what PAME can do with animated demonstrations
4. Browser Authentication: Seamless login through your web browser
5. Instant Setup: Get your auth token and access to all 34 tools

$ pame

╔═══════════════════════════════════════════════════════════════════╗
║                                                                   ║
║                     Welcome to PAME AI                            ║
║           The AI Operating System for Developers                  ║
║                                                                   ║
╚═══════════════════════════════════════════════════════════════════╝

👋 Hello! I'm your AI assistant, and I'm here to help you build
   amazing AI applications with our 34-tool enterprise stack.

With PAME, you can:
  🤖  Access 11+ AI providers through one SDK
  🎨  Build visual AI workflows with drag-and-drop
  🎙️  Create voice-enabled applications
  ✨  Add stunning 3D animated interfaces
  💰  Monetize with built-in billing
  🚀  Deploy globally with edge computing

First, what should I call you? [Developer]

🔐 Authentication

PAME uses a secure browser-based authentication flow similar to GitHub CLI:

$ pame login

🔐 Let's authenticate you with PAME...

📱 Opening your browser to authenticate...
   If it doesn't open automatically, visit:
   https://app.pame.ai/cli-auth?session=abc123

🔗 Local callback server running on port 52941

✅ Authentication successful!

🎉 Welcome to PAME!

Authenticated as: [email protected]
Subscription: Pro

─────────────────────────────────────────

Your account includes access to:

• 11+ AI Providers (OpenAI, Anthropic, Google, etc.)
• Visual Workflow Builder
• 3D Animated UI Components
• Voice Synthesis & Transcription
• Real-time Collaboration
• Usage Analytics & Billing

─────────────────────────────────────────

Alternative: API Key Authentication

You can also authenticate using an API key from your PAME dashboard:

$ pame login --api-key

🔑 Authenticate with API Key

Get your API key from: https://app.pame.ai/settings/api-keys

Enter your PAME API key: pame_sk_...

✅ Authenticated successfully with API key.

📦 Creating Projects

After authentication, create AI projects with a single command:

$ pame init my-ai-app

🚀 Creating a new PAME AI project

Choose a project template:
❯ Complete Platform - Full 34-tool stack
  AI Chatbot - Streaming chat interface
  Voice Assistant - Speech-to-speech AI
  Visual Workflow - Drag-and-drop builder
  Enterprise API - Production backend
  Minimal - Basic setup

Select additional features:
✓ Streaming AI responses
✓ 3D animated backgrounds
✓ Visual workflow builder
✓ Voice input/output
✓ Authentication system
✓ Payment processing
✓ Usage analytics

Select AI providers to include:
✓ OpenAI (GPT-4)
✓ Anthropic (Claude)
✓ Google (Gemini)
  Azure OpenAI
  AWS Bedrock
  ...

✅ Project created successfully!

✨ Your AI project is ready!

Next steps:
  cd my-ai-app
  npm run dev

Useful commands:
  • pame create agent my-agent - Create an AI agent
  • pame create workflow my-flow - Create a workflow
  • pame deploy - Deploy to production

🛠️ Available Commands

Core Commands

• pame - Show welcome screen (first time) or help
• pame login - Log in to PAME platform
• pame init [name] - Create a new AI project
• pame create <type> <name> - Create agents, workflows, functions
• pame deploy - Deploy your application
• pame config - Manage CLI configuration

Project Commands

• pame agent - Manage AI agents
  • pame agent --list - List all agents
  • pame agent --test <name> - Test an agent
  • pame agent --deploy <name> - Deploy an agent

Development Commands

• pame sync - Sync with PAME platform
• pame logs - View deployment logs
• pame usage - Check usage statistics

🔑 How Authentication Works

1. Secure Token Storage: Auth tokens are encrypted and stored locally using machine ID
2. Automatic Refresh: Tokens are refreshed automatically when needed
3. Multi-Account Support: Switch between accounts with pame login
4. API Key Injection: Your PAME auth automatically provides API keys for all 34 tools

Token Management

Your PAME authentication provides automatic access to:

• OpenAI API keys
• Anthropic API keys
• Google AI API keys
• Azure OpenAI endpoints
• AWS Bedrock credentials
• And 29 more services...

No need to manage individual API keys - PAME handles it all!

🎨 Features

Complete AI Provider Coverage

Access all major AI providers through a unified interface:

• LLMs: OpenAI, Anthropic, Google, Azure, AWS, xAI
• Specialized: Perplexity (web search), ElevenLabs (voice), Rev.ai (transcription)
• Multi-Cloud: Deploy to any cloud provider

Visual Development

• Drag-and-drop AI workflow builder
• Real-time preview and testing
• Export visual workflows to code

Voice-First Applications

• Complete voice synthesis (29+ languages)
• High-accuracy transcription
• Real-time voice conversations

3D Animated Interfaces

• Stunning WebGL backgrounds (Birds, Fog, Waves, Globe)
• Interactive and responsive
• Mobile-optimized performance

Enterprise Features

• Authentication and authorization
• Usage tracking and billing
• Team collaboration
• Compliance and security

🌟 Example Workflow

# 1. Install PAME CLI
npm install -g pame

# 2. First run - delightful onboarding
pame

# 3. Log in (browser opens automatically)
pame login

# 4. Create a new project
pame init my-voice-assistant --template voice-assistant

# 5. Navigate to project
cd my-voice-assistant

# 6. Start development
npm run dev

# 7. Create an AI agent
pame create agent customer-support

# 8. Deploy to production
pame deploy

🔧 Configuration

View and manage your configuration:

# List all config values
pame config --list

# Set a config value
pame config --set apiEndpoint=https://api.pame.ai

# Get a specific value
pame config --get userName

📚 Resources

• Documentation: https://pame.ai/docs
• API Reference: https://pame.ai/api
• Examples: https://github.com/pame-ai/examples
• Discord Community: https://discord.gg/pame-ai

🤝 Support

• Email: [email protected]
• Discord: Join our community for real-time help
• GitHub Issues: Report bugs and request features

📄 License

MIT © PAME AI

Built with ❤️ by the PAME team. Making AI development delightful, one command at a time.