@embedapi/cli

The official command-line interface for EmbedAPI services. This CLI provides a straightforward way to interact with AI models, manage your applications, and integrate various AI services directly from your terminal.

Prerequisites

1. Create an Account: Sign up at embedapi.com
2. Get API Key: Generate your API key from the dashboard
3. Add Credits: Fund your account with credits to start using the services
   • Visit embedapi.com/billing
   • Add credits using your preferred payment method
   • Start with as little as $5 to try out the service

Installation

npm install -g @embedapi/cli

Quick Start

embedapi

On first run, you'll be prompted for your API key. This will be securely encrypted and stored locally.

Features

• Interactive AI Chat: Real-time conversations with AI models
• Multiple AI Services: Support for OpenAI, Anthropic, VertexAI, and more
• Secure Storage: Encrypted local storage of your API credentials
• Real-time Feedback: Loading indicators for ongoing operations
• Service Switching: Seamlessly switch between different AI providers and models

Commands

During an interactive session, the following commands are available:

| Command | Shorthand | Description | |---------|-----------|-------------| | $switch-model <service> <model> | $sm | Switch AI service/model | | $list-models | $ll | List available models | | exit or quit | - | Exit the CLI |

Examples

Switch to Claude 3:

$switch-model anthropic claude-3

List Available Models:

$list-models

Chat with AI: Simply type your message and press enter:

Tell me about the future of AI.

Security

Your API key is protected using:

• AES-256-CBC encryption with random initialization vectors
• Restricted file permissions (600)
• Local storage in your home directory

Configuration

The CLI creates two files in your home directory:

• .embedapi_key: Stores your encrypted API key
• .embedapi-config: Stores your CLI preferences (optional)

Pricing

• Pay-as-you-go model with competitive rates
• View current pricing at embedapi.com/pricing
• Monitor usage in real-time from your dashboard

Troubleshooting

Common issues and solutions:

Reset API Key

rm ~/.embedapi_key

Then restart the CLI and enter your new API key.

Connection Issues

• Verify your internet connection
• Check API key validity
• Ensure selected service/model is available
• Verify you have sufficient credits in your account

Loading Indicator Stuck

Press Ctrl+C to cancel the current operation. Your session will remain active.

Environment Variables

Optional environment variables for advanced configuration:

EMBEDAPI_DEBUG=true      # Enable debug logging
EMBEDAPI_CONFIG_PATH     # Custom config file location

Support

• Documentation: docs.embedapi.com
• Issues: GitHub Issues
• Discord: Join our community
• Email: [email protected]

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

MIT License - see LICENSE for details.