Dria

A powerful AI-powered coding assistant built on Claude AI, providing intelligent code completion, generation, and assistance directly in your terminal.

Author

Sohel Danial

• Student ID: 0524634533
• Email: [email protected]
• GitHub: danielsohel/dria-dev-

Table of Contents

• Features
• Prerequisites
• Installation
  • Windows
  • macOS
  • Linux
• Building from Source
• Usage
• Configuration
• Commands
• Contributing
• License

Features

• AI-powered code completion and generation
• Terminal-based user interface (TUI)
• Session management for multiple conversations
• Model selection and configuration
• Custom agents for specialized tasks
• File context awareness
• Git integration
• Cross-platform support (Windows, macOS, Linux)

Prerequisites

Before installing Dria, ensure you have the following installed on your system:

1. Node.js (v18 or higher)
2. Bun (v1.2.21 or higher)
3. Go (v1.21 or higher) - for building the TUI component

Installation

Windows

Step 1: Install Node.js

Download and install Node.js from the official website:

# Visit https://nodejs.org/ and download the LTS version
# Or use Chocolatey:
choco install nodejs-lts

Verify the installation:

node --version
npm --version

Step 2: Install Bun

# Using PowerShell
powershell -c "irm bun.sh/install.ps1|iex"

Verify the installation:

bun --version

Step 3: Install Go

Download and install Go from the official website:

# Visit https://go.dev/dl/ and download the Windows installer
# Or use Chocolatey:
choco install golang

Verify the installation:

go version

Step 4: Clone and Build Dria

# Clone the repository
git clone https://github.com/danielsohel/dria-dev-.git dria
cd dria

# Install dependencies
bun install

# Build the project
bun run build

Step 5: Add to PATH (Optional but Recommended)

To use dria from anywhere in your terminal, add the bin directory to your PATH:

Method 1: Using System Environment Variables (GUI)

1. Press Win + X and select "System"
2. Click "Advanced system settings"
3. Click "Environment Variables"
4. Under "User variables" or "System variables", find and select "Path"
5. Click "Edit"
6. Click "New"
7. Add the full path to the bin directory: C:\Users\YourUsername\path\to\dria\packages\opencode\bin
   • Replace YourUsername and path\to\dria with your actual paths
8. Click "OK" on all windows
9. Restart your terminal for changes to take effect

Method 2: Using PowerShell (Command Line)

# Get the full path to the bin directory
$driaPath = "C:\Users\YourUsername\path\to\dria\packages\opencode\bin"

# Add to user PATH (recommended)
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$driaPath", "User")

# Or add to system PATH (requires admin privileges)
# [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$driaPath", "Machine")

Verify the PATH setup:

# Close and reopen your terminal, then run:
dria --version

macOS

Step 1: Install Homebrew (if not already installed)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 2: Install Node.js

brew install node@18

Verify the installation:

node --version
npm --version

Step 3: Install Bun

curl -fsSL https://bun.sh/install | bash

Verify the installation:

bun --version

Step 4: Install Go

brew install go

Verify the installation:

go version

Step 5: Clone and Build Dria

# Clone the repository
git clone https://github.com/danielsohel/dria-dev-.git dria
cd dria

# Install dependencies
bun install

# Build the project
bun run build

Step 6: Add to PATH (Optional but Recommended)

To use dria from anywhere in your terminal, add the bin directory to your PATH:

For Zsh (default on macOS Catalina and later):

# Open your .zshrc file
nano ~/.zshrc

# Add this line at the end (replace /path/to/dria with your actual path)
export PATH="$PATH:/path/to/dria/packages/opencode/bin"

# Save and exit (Ctrl+X, then Y, then Enter)

# Reload your shell configuration
source ~/.zshrc

For Bash:

# Open your .bash_profile or .bashrc file
nano ~/.bash_profile

# Add this line at the end (replace /path/to/dria with your actual path)
export PATH="$PATH:/path/to/dria/packages/opencode/bin"

# Save and exit (Ctrl+X, then Y, then Enter)

# Reload your shell configuration
source ~/.bash_profile

Quick command to get the full path:

# Run this from inside the dria directory
echo "export PATH=\"\$PATH:$(pwd)/packages/opencode/bin\""

# Copy the output and paste it into your .zshrc or .bash_profile

Verify the PATH setup:

# Close and reopen your terminal, then run:
dria --version

Linux

Step 1: Install Node.js

Ubuntu/Debian:

# Using NodeSource repository
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora:

sudo dnf install nodejs

Arch Linux:

sudo pacman -S nodejs npm

Verify the installation:

node --version
npm --version

Step 2: Install Bun

curl -fsSL https://bun.sh/install | bash

Verify the installation:

bun --version

Step 3: Install Go

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y golang

Fedora:

sudo dnf install golang

Arch Linux:

sudo pacman -S go

Verify the installation:

go version

Step 4: Clone and Build Dria

# Clone the repository
git clone https://github.com/danielsohel/dria-dev-.git dria
cd dria

# Install dependencies
bun install

# Build the project
bun run build

Step 5: Add to PATH (Optional but Recommended)

To use dria from anywhere in your terminal, add the bin directory to your PATH:

For Bash (most common on Linux):

# Open your .bashrc file
nano ~/.bashrc

# Add this line at the end (replace /path/to/dria with your actual path)
export PATH="$PATH:/path/to/dria/packages/opencode/bin"

# Save and exit (Ctrl+X, then Y, then Enter)

# Reload your shell configuration
source ~/.bashrc

For Zsh:

# Open your .zshrc file
nano ~/.zshrc

# Add this line at the end (replace /path/to/dria with your actual path)
export PATH="$PATH:/path/to/dria/packages/opencode/bin"

# Save and exit (Ctrl+X, then Y, then Enter)

# Reload your shell configuration
source ~/.zshrc

Quick command to get the full path:

# Run this from inside the dria directory
echo "export PATH=\"\$PATH:$(pwd)/packages/opencode/bin\""

# Copy the output and paste it into your .bashrc or .zshrc

Alternative: System-wide installation (requires sudo):

# Create a symbolic link in /usr/local/bin
sudo ln -s /path/to/dria/packages/opencode/bin/dria /usr/local/bin/dria

# Make sure the file is executable
chmod +x /path/to/dria/packages/opencode/bin/dria

Verify the PATH setup:

# Close and reopen your terminal, then run:
dria --version

Building from Source

If you want to build Dria from source:

# Navigate to the project directory
cd dria

# Install dependencies
bun install

# Run type checking (optional)
bun run typecheck

# Build the project
bun run build

# The executable will be available in packages/opencode/bin/

Usage

After installation, you can start Dria by running:

# If added to PATH
dria

# Or from the bin directory
./packages/opencode/bin/dria

First Time Setup

On first run, Dria will guide you through the initial configuration:

1. Choose your AI provider (Claude, OpenAI, etc.)
2. Enter your API key
3. Select your preferred model

Configuration

Dria stores its configuration in:

• Windows: %USERPROFILE%\.config\dria\
• macOS/Linux: ~/.config/dria/

You can edit the configuration file to customize:

• API keys and providers
• Default models
• Keybindings
• Theme preferences

Commands

Dria supports various slash commands in the TUI:

• /help - Show help information
• /info - Display project and author information
• /models - List and select available models
• /agents - List and select available agents
• /sessions - Manage conversation sessions
• /new or /clear - Start a new session
• /export - Export the current conversation
• /quit or /exit - Exit the application

Project Structure

dria/
├── packages/
│   ├── opencode/        # Main application (Node.js/TypeScript)
│   │   ├── bin/         # Executable files (dria/dria.cmd)
│   │   └── src/         # Source code
│   ├── tui/             # Terminal UI component (Go)
│   └── plugin/          # Plugin system
├── node_modules/        # Dependencies
└── package.json         # Root project configuration

Troubleshooting

Common Issues

Issue: bun: command not found

• Solution: Ensure Bun is installed and added to your PATH

Issue: go: command not found

• Solution: Install Go and verify it's in your PATH

Issue: Build fails with module errors

• Solution: Run bun install to ensure all dependencies are installed

Issue: Permission denied when running dria

• Solution:
  • Linux/macOS: Run chmod +x packages/opencode/bin/dria
  • Windows: Ensure you have execution permissions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License

For more information, visit the GitHub repository.