Developer Quick Start

Get started with the Terminal development environment and start contributing to the project.

Prerequisites

✅ Python 3.10+ and Git installed
✅ Poetry for dependency management
✅ Pre-commit for git hooks
✅ Terminal/Command Line environment

Get AWS Credentials

If you don’t have AWS Bedrock access:

1. Go to AWS Bedrock Console
2. Request access to Amazon Nova Pro model
3. Note your Access Key ID and Secret Key

Installation & Setup

Step 1: Install Ona Terminal (2 minutes)

Windows

Option 1: Windows Installer (Recommended)

1. Download ona-terminal-setup.exe from GitHub Releases
2. Run installer as administrator
3. Follow installation wizard
4. Verify: Open Command Prompt and run ona-terminal --version

Option 2: Manual Installation

git clone https://github.com/AsobaCloud/terminal.git
cd terminal
python -m venv venv
call venv\Scripts\activate.bat
pip install -e .

Linux/macOS

# Clone repository
git clone https://github.com/AsobaCloud/terminal.git
cd terminal

# Install with automatic PATH setup
./install.sh

# Reload shell configuration
source ~/.bashrc  # or ~/.zshrc, or restart terminal

Step 2: Configure AWS (2 minutes)

# Configure AWS credentials
aws configure
# Enter: Access Key ID, Secret Access Key, Region (us-east-1)

# Test Nova Pro model (recommended for best availability)
aws bedrock invoke-model \
  --model-id amazon.nova-pro-v1:0 \
  --body '{"messages":[{"role":"user","content":[{"text":"test"}]}],"inferenceConfig":{"max_new_tokens":10}}' \
  --region us-east-1 \
  --cli-binary-format raw-in-base64-out

Immediate CLI Validation (1 minute)

Launch Interactive Mode

ona-terminal

Run Validation Commands

Once in the CLI, test these commands:

# Show available commands
🤖 | /help

# List all available commands
🤖 | /commands

# Generate your first function
🤖 | generate a python function that calculates fibonacci numbers

# Check system status
🤖 | /status

# Show available models
🤖 | /models

Expected Output

✅ System Status:

✅ AWS Bedrock connection: Connected (Nova Pro active)
✅ Model access: Amazon Nova Pro (primary), Nova Lite (fallback)
✅ Throttling resistance: Availability cache enabled, circuit breaker ready

✅ Generated Code:

def fibonacci(n):
    """Calculate the nth Fibonacci number using iteration."""
    if n <= 0:
        return 0
    elif n == 1:
        return 1
    
    a, b = 0, 1
    for _ in range(2, n + 1):
        a, b = b, a + b
    
    return b

# Usage example
print(fibonacci(10))  # Output: 55

Troubleshooting

🚨 “AccessDeniedException”:

# Request model access in AWS Console:
# 1. Go to AWS Bedrock > Model access
# 2. Request access to Amazon Nova Pro
# 3. Wait for approval (usually immediate)

🚨 “ThrottlingException”: ✅ No action needed! Ona Terminal automatically handles throttling with:

• Availability caching (5-minute TTL)
• Circuit breaker protection
• Exponential backoff

🚨 “Command not found”:

# Manually add to PATH
export PATH=$PATH:$HOME/.local/bin
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

What’s Next?

1. Learn Interactive Commands - Master the / command system
2. Explore Agentic Workflows - Understand the OODA loop
3. Add Custom Models - Configure your own fine-tuned models

Continue to Interactive Commands

Get Help & Stay Updated