Installation
This guide walks you through setting up Agentic Signal for development and running it as a web app in your browser.
If you want to use the packaged Windows app without development, see Run as Windows App.
Installation Options
Choose your preferred installation method:
- 🐳 Docker (Recommended)
- 🔧 Manual Installation
Prerequisites
- Docker with BuildKit support
- Git (to clone the repository)
- Ollama (optional, for local AI features)
1. Prerequisites Setup
-
Install Docker
Follow installation instructions from docker.com -
Install Ollama (AI Models - Optional)
Download from ollama.com
2. Quick Docker Setup
-
Clone the repository:
git clone https://github.com/code-forge-temple/agentic-signal
cd agentic-signal -
Build and run with Docker:
# On Linux/macOS:
./docker-build.sh
# On Windows:
docker-build.bat
Prerequisites
- Bun (for frontend and docs)
- Deno 2.0+ for the backend
- Ollama (optional, for local AI features)
1. Prerequisites Setup
-
Install Bun (Frontend & Docs Runtime)
Follow installation instructions from bun.sh -
Install Deno (Backend Runtime)
Follow installation instructions from deno.land (version 2.0+) -
Install Ollama (AI Models - Optional)
Download from ollama.com
2. Clone and Setup Project
# Clone the repository
git clone https://github.com/code-forge-temple/agentic-signal
cd agentic-signal
# Install root dependencies
bun install
# Install client dependencies
cd client && bun install && cd ..
# Install docs dependencies
cd docs && bun install && cd ..
Optional Integrations
-
(Optional) Set up Google OAuth2 Client for Google integrations:
If you want to use Gmail, Google Drive, or Google Calendar nodes, follow the Google OAuth2 Client Setup guide to create your credentials in Google Cloud Console. -
(Optional) Set up Reddit OAuth2 Client for Reddit integrations:
If you want to use the Reddit nodes / tools (available only in PRO subscription tier), follow the Reddit OAuth2 Client Setup guide to create your credentials in Reddit Developer Portal.
Configuration
See Configuration for detailed instructions on:
- Setting up Ollama host and models
- Configuring browser executable path
Next Steps
After installation, continue to Quick Start to begin using Agentic Signal.
Troubleshooting
Manual Installation Issues
- Bun installation: Make sure you have the latest version of Bun installed
- Deno compatibility: Ensure you're using Deno 2.0 or later
- Dependency conflicts: Try clearing node_modules and reinstalling dependencies