Zyora CLI

AI-powered code generation and security scanning from the command line.

Installation

pip install zyora-cli

Or install from source:

git clone https://github.com/zyoralabs/zyora-cli
cd zyora-cli
pip install -e .

Quick Start

1. Get your API key at app.zyoralabs.com/register

2. Configure the CLI:

   zyora config set api_key zy-your-api-key-here
   

3. Start using Zyora:

   # Interactive mode (like Claude Code)
   zyora
   
   # One-shot chat
   zyora chat "Write a Python function to validate emails"
   
   # Scan code for vulnerabilities
   zyora scan file app.py
   

Features

Interactive Mode

Start an interactive session with context awareness:

zyora

Commands in interactive mode:

Command	Description
/help	Show help
/clear	Clear conversation
/context	Show files in context
/add <file>	Add file to context
/remove <file>	Remove from context
/scan <file>	Scan file for vulnerabilities
/project	Show project summary
/model	Show model info
/config	Show configuration
/exit	Exit

Tips:

• Use @filename to reference files in your prompt
• Pipe code directly: cat app.py | zyora chat "explain this"

Chat Mode

Send one-off prompts:

# Simple prompt
zyora chat "Write a function to merge two sorted lists"

# With file context
zyora chat "Review this code" -c main.py -c utils.py

# From file
zyora chat -f prompt.txt

# Pipe input
cat code.py | zyora chat "Explain this code"

# Save output
zyora chat "Write a REST API" -o api.py

Security Scanning

Scan code for vulnerabilities:

# Scan a single file
zyora scan file app.py

# Scan a directory
zyora scan dir ./src

# Scan with specific extensions
zyora scan dir ./src --ext py,js

# Save results
zyora scan file app.py -o report.md

The scanner detects:

• SQL Injection (CWE-89)
• Cross-Site Scripting (CWE-79)
• Command Injection (CWE-78)
• Path Traversal (CWE-22)
• Hardcoded Credentials (CWE-798)
• And many more...

Configuration

# Show all config
zyora config show

# Set values
zyora config set api_key zy-xxx
zyora config set max_tokens 8192
zyora config set temperature 0.5

# Get a value
zyora config get model

# Reset to defaults
zyora config reset

Environment variables:

• ZYORA_API_KEY - API key
• ZYORA_API_BASE - API base URL
• ZYORA_MODEL - Model to use
• ZYORA_MAX_TOKENS - Max response tokens

Examples

Generate Code

# Generate a REST API
zyora chat "Create a FastAPI REST API with user authentication"

# Generate with context
zyora chat "Add error handling to this" -c server.py

Review Code

# Code review
cat pull_request.diff | zyora chat "Review this code change"

# Architecture review
zyora chat "Review the architecture" -c main.py -c models.py -c routes.py

Security Audit

# Full project scan
zyora scan dir ./src --recursive -o security-report.md

# Quick scan
zyora scan file api/auth.py

Interactive Session

$ zyora

╔═══════════════════════════════════════════════════════════════╗
║   ███████╗██╗   ██╗ ██████╗ ██████╗  █████╗                   ║
║   ╚══███╔╝╚██╗ ██╔╝██╔═══██╗██╔══██╗██╔══██╗                  ║
║     ███╔╝  ╚████╔╝ ██║   ██║██████╔╝███████║                  ║
║    ███╔╝    ╚██╔╝  ██║   ██║██╔══██╗██╔══██║                  ║
║   ███████╗   ██║   ╚██████╔╝██║  ██║██║  ██║                  ║
║   ╚══════╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝                  ║
║                                                               ║
║   AI-Powered Code Generation & Security Scanning              ║
╚═══════════════════════════════════════════════════════════════╝

Type /help for commands, /exit to quit

zyora > /add src/main.py
Added: src/main.py

zyora [1] > What does this code do?
...

API Usage

You can also use Zyora programmatically:

from zyora.client import ZyoraClient, Message

client = ZyoraClient(api_key="zy-xxx")

# Simple chat
response = client.chat([
    Message(role="user", content="Write hello world in Python")
])
print(response.content)

# Streaming
for chunk in client.chat(messages, stream=True):
    print(chunk, end="")

Requirements

• Python 3.9+
• API key from app.zyoralabs.com

License

MIT License - see LICENSE for details.

Links

• Website: zyoralabs.com
• API Portal: app.zyoralabs.com
• Documentation: app.zyoralabs.com/docs
• Model: huggingface.co/zyoralabs/Zyora-DEV-32B