Seron CLI

A powerful CLI for chatting with multiple AI models - now with automatic code execution

███████╗███████╗██████╗  ██████╗ ███╗   ██╗
██╔════╝██╔════╝██╔══██╗██╔═══██╗████╗  ██║
███████╗█████╗  ██████╔╝██║   ██║██╔██╗ ██║
╚════██║██╔══╝  ██╔══██╗██║   ██║██║╚██╗██║
███████║███████╗██║  ██║╚██████╔╝██║ ╚████║
╚══════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝

Open source | Multiple AI providers | Automatic code execution

---

About Seron

Seron is a CLI tool that lets you chat with multiple AI models from your terminal. It can automatically create files, install packages, and run commands based on your conversations. No more switching between different AI websites or copying terminal commands.

Installation

npm install -g seron-cli

Or install from source:

git clone https://github.com/nexiloop/seron-cli.git
cd seron-cli
npm install && npm run build && npm link

Configuration

Seron saves all configuration locally in ~/.seron-cli/config.json. Your data stays on your machine.

API Keys you'll need:

• OpenAI: Get from OpenAI Platform
• Anthropic: Get from Anthropic Console
• xAI: Available at x.ai
• HuggingFace: Free from HuggingFace

Local models:

Install Ollama for local models that don't require API keys.

Commands

seron

Shows the banner and interactive menu

seron setup

Configuration wizard for API keys and default model

seron chat or seron c

Start chatting with AI that can create files and run commands automatically

New Features:

• Automatic file creation: Just say "create a React app" and watch it happen
• Auto command execution: Seron runs npm install, builds, and more
• Real-time progress: See exactly what Seron is doing
• Zero copy-paste: Everything happens automatically in your directory

Options:

• -m, --model <model> - Choose AI model for this session
• -s, --system <prompt> - Set custom system prompt

Examples:

# Basic enhanced chat
seron chat

# Build a complete React app automatically
seron chat -m gpt-4
# Then say: "Create a React todo app with TypeScript and Tailwind CSS"

# Code review mode
seron chat -m gpt-4 -s "universal-code"

# Creative writing with Claude
seron chat -m claude-3.5-sonnet -s "creative"

# Local model
seron chat -m llama3

seron models

List all available models and their status

seron config

Change settings

Options:

• -k, --key <key> - Set an API key
• -m, --model <model> - Change default model

seron server

Start the Seron AI server to use with the web UI.

Web UI

Seron now includes a web UI to chat with the AI in your browser.

How to use:

1. Start the server:

   seron server

   The server will start on http://localhost:3000.

2. Start the web UI:

   cd web
   npm install
   npm run dev

   The web UI will be available at http://localhost:5173.

3. Configure API keys:

   • Open the web UI in your browser.
   • Go to the "Settings" page.
   • Enter your API keys. They will be stored in your browser's local storage.

Real Examples

Create a complete Next.js app:

seron chat -m gpt-4

Then say: "Create a Next.js blog with TypeScript, Tailwind CSS, and sample posts"

Watch Seron:

• Create package.json
• Install next, react, typescript...
• Create app/page.tsx
• Create tailwind.config.js
• Run npm run build
• Your blog is ready!

Build a Python web scraper:

seron chat -m claude-3.5-sonnet

Then say: "Create a Python script that scrapes Reddit posts and saves them to CSV"

Watch Seron:

• Create scraper.py
• Create requirements.txt
• Run pip install -r requirements.txt
• Your scraper is ready!

Supported Models

OpenAI

• GPT-4 - Most capable model
• GPT-4 Turbo - Faster and more efficient
• GPT-3.5 Turbo - Good for most tasks
• GPT-4o - Latest model with vision

Anthropic

• Claude 3.5 Sonnet - Balanced performance
• Claude 3 Opus - Most capable Claude model
• Claude 3 Haiku - Fastest responses

xAI

• Grok-1 - Conversational AI
• Grok-2 - Latest Grok model

Local Models (via Ollama)

• Llama 3 - Meta's open source model
• Code Llama - Specialized for coding
• Mistral - European AI model
• Mixtral - Mixture of experts model

HuggingFace

• Any model - Thousands of community models
• Custom models - Your own fine-tuned models

Chat Commands

While chatting:

• exit - Exit the chat
• clear - Clear chat history
• help - Show help and features
• /model <model-id> - Switch models
• /system <prompt> - Change AI personality

Progress Messages

Seron shows what it's doing:

• Seron is thinking - Processing your request
• Seron is generating - Creating the response
• Seron is creating file filename.js - Making new files
• Seron is editing file package.json - Modifying files
• Seron is running command npm install react - Executing commands
• Seron is installing packages - Managing dependencies
• Success messages - When operations complete

Development

Setup:

git clone https://github.com/nexiloop/seron-cli.git
cd seron-cli
npm install

Development mode:

npm run dev

Build:

npm run build

Test:

npm run build
node dist/cli.js chat -m gpt-4

Project Structure

seron-cli/
├── src/
│   ├── cli.ts              # Main entry point
│   ├── commands/           # All commands (enhanced chat)
│   ├── services/           # AI integrations + file system
│   ├── utils/             # Progress messages + banner
│   ├── config/            # Model configs and prompts
└── README.md              # You are here

Contributing

1. Star this repository
2. Fork it
3. Make improvements
4. Send a pull request
5. Get credited as a contributor

Issues and Support

• Report bugs: GitHub Issues
• Feature requests: GitHub Discussions

License

MIT License - use this code however you want.

Give us a star

If Seron helped you, please star the repository!

---

Built by developers, for developers
Maintained by NexiLoop
Enhanced with AI automation

v1.0.2 includes important bug fixes for better user experience.