Installation

import { Tabs, TabItem } from ‘@astrojs/starlight/components’;

Talon is available across multiple platforms: desktop (macOS, Windows, Linux), mobile (iOS, Android), and web. This guide covers installation methods for each platform.

Prerequisites

Before installing Talon, ensure you have the following tools installed:

• Rust 1.70 or later
• Node.js 18 or later
• npm or pnpm (comes with Node.js)

Verify Your Installation

Check your versions by running:

rustc --version
node --version
npm --version

Desktop App

The fastest way to get started with Talon on desktop is to download pre-built binaries.

Download Pre-Built Binaries

Visit the Talon GitHub Releases page and download the appropriate installer for your platform:

• macOS: Talon.dmg (Apple Silicon and Intel)
• Windows: Talon.exe (Windows 10 and later)
• Linux: Talon.AppImage (Universal Linux)

macOS Installation

1. Download Talon.dmg
2. Open the DMG file
3. Drag the Talon app to your Applications folder
4. Launch Talon from Applications

Windows Installation

1. Download Talon.exe
2. Run the installer
3. Follow the installation wizard
4. Launch Talon from your Start Menu or desktop shortcut

Linux Installation

1. Download Talon.AppImage
2. Make it executable:

chmod +x Talon.AppImage

3. Run the AppImage:

./Talon.AppImage

Alternatively, integrate it into your desktop environment or create a symlink in a directory on your PATH.

Build from Source

If you prefer to build Talon from source or contribute to development, follow these steps.

Clone the Repository

git clone https://github.com/talon-app/talon.git
cd talon

Install Dependencies

npm install
# or
pnpm install

Build the Desktop App

Using Cargo Tauri Build

The recommended way to build the complete desktop application:

cd src-tauri
cargo tauri build --release

This command will:

• Compile the Rust backend
• Bundle the frontend assets
• Generate platform-specific installers

Using Cargo Build Only

To build just the Rust backend without creating installers:

cd src-tauri
cargo build --release

The compiled binary will be in src-tauri/target/release/.

Run in Development Mode

For development with hot-reload:

npm run tauri dev

This starts both the frontend development server and the Tauri app in debug mode.

Mobile App

Talon is available for iOS and Android through the App Store and Google Play Store.

App Store & Google Play

The easiest way to install on mobile:

1. iOS: Open the App Store and search for “Talon”
2. Android: Open Google Play Store and search for “Talon”
3. Tap “Install” and follow the prompts

Build from Source

If you want to build the mobile app from source, you’ll need to set up Expo and build tools.

Prerequisites for Mobile Build

• Expo CLI: Install globally with npm install -g expo-cli
• EAS CLI: Install with npm install -g eas-cli
• Apple Developer Account (for iOS builds)
• Google Play Developer Account (for Android builds)

Build the Mobile App

Navigate to the mobile directory and use EAS Build:

cd mobile
eas build

You’ll be prompted to select your platform:

• Select ios for iOS builds
• Select android for Android builds
• Select all to build for both platforms

Local Development

For local development and testing on Android emulator or iOS simulator:

cd mobile
npm install
npm start

Then:

• Press a for Android
• Press i for iOS
• Scan the QR code with Expo Go app (iOS/Android)

Web Access

Talon can be accessed through any modern web browser. You have two options:

Hosted Version

The easiest way to access Talon is through our hosted instance:

https://talon.aieduapp.com

Simply open this URL in your web browser and log in with your credentials.

Self-Hosted / Local Access

If you’re running Talon locally or have a custom deployment, access it through your configured URL. Typically this is:

http://localhost:3000

Or whatever port and URL your deployment uses.

Browser Requirements

• Chrome 90+
• Firefox 88+
• Safari 14+
• Edge 90+

Troubleshooting

macOS

“Talon” is damaged and can’t be opened

1. Open System Preferences → Security & Privacy
2. Under the General tab, click “Open Anyway” next to the Talon warning
3. Confirm by clicking “Open”

Windows

Windows Defender SmartScreen Warning

1. Click “More info” on the SmartScreen dialog
2. Click “Run anyway”

Linux

AppImage won’t launch

Ensure the file is executable:

chmod +x Talon.AppImage
./Talon.AppImage

If you encounter FUSE issues, try:

./Talon.AppImage --appimage-extract
./squashfs-root/AppRun

Build Issues

If you encounter build issues:

1. Clean your build cache:

cargo clean
cd src-tauri && cargo clean

2. Verify Rust toolchain is up to date:

rustup update

3. Check that all dependencies are installed:

npm install
cargo build

Getting Help

If you encounter issues during installation:

• Check the GitHub Issues page
• Join our community Discord server
• Review the FAQ section

Next Steps

After installation, proceed to the Getting Started guide to begin using Talon.