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 Docker image:
# 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. -
(Optional) Set up Slack Bot for Slack integrations:
If you want to use the Slack Input and Slack Output nodes (available only in PRO subscription tier), follow the Slack Bot Setup guide to create and configure your Slack app.
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