Installation — termiflow

Using Go

Recommended

If you have Go 1.22+ installed, this is the fastest way to get started.

$ Terminal

$ go install github.com/oluoyefeso/termiflow/cmd/termiflow@latest

Make sure $GOPATH/bin is in your PATH.

Using Homebrew

Coming Soon

Available for macOS and Linux via our Homebrew tap.

$ Terminal

$ brew install termiflow/tap/termiflow

Using the Install Script

One-liner that detects your platform and installs the appropriate binary.

$ Terminal

                            $ curl -fsSL https://raw.githubusercontent.com/oluoyefeso/termiflow/main/scripts/install.sh | bash
                        

ℹ️ The script installs to /usr/local/bin by default. You can customize the install location by setting INSTALL_DIR before running.

Direct Download

Download pre-built binaries for your platform from our GitHub Releases.

Platform	Architecture	Download
Linux	x86_64	termiflow_VERSION_linux_amd64.tar.gz
Linux	ARM64	termiflow_VERSION_linux_arm64.tar.gz
macOS	Intel	termiflow_VERSION_darwin_amd64.tar.gz
macOS	Apple Silicon	termiflow_VERSION_darwin_arm64.tar.gz
Windows	x86_64	termiflow_VERSION_windows_amd64.zip

⚠️ Replace VERSION with the actual version number (e.g., 1.0.0). Check the releases page for exact filenames.

                                $
                                After downloading (Linux/macOS)
                            

                            # Extract and install
$ tar -xzf termiflow_VERSION_linux_amd64.tar.gz
$ sudo mv termiflow /usr/local/bin/
$ chmod +x /usr/local/bin/termiflow
                        

Using Docker

Run termiflow in a container without installing anything locally.

$ Pull the image

$ docker pull ghcr.io/oluoyefeso/termiflow:latest

                                $
                                Run a command
                            

                            # Ask a question
$ docker run -it ghcr.io/oluoyefeso/termiflow ask "your question"

# With persistent config and data
$ docker run -it \
  -v ~/.config/termiflow:/home/termiflow/.config/termiflow \
  -v ~/.local/share/termiflow:/home/termiflow/.local/share/termiflow \
  ghcr.io/oluoyefeso/termiflow feed
                        

Linux Packages

Native packages for popular Linux distributions.

Debian / Ubuntu (.deb)

                                $
                                Terminal
                            
                            $ curl -LO https://github.com/oluoyefeso/termiflow/releases/latest/download/termiflow_VERSION_amd64.deb
$ sudo dpkg -i termiflow_VERSION_amd64.deb

RHEL / Fedora (.rpm)

                                $
                                Terminal
                            
                            $ curl -LO https://github.com/oluoyefeso/termiflow/releases/latest/download/termiflow_VERSION_amd64.rpm
$ sudo rpm -i termiflow_VERSION_amd64.rpm

Arch Linux (AUR)

                                $
                                Terminal
                            
                            $ yay -S termiflow-bin

Quick Start

After installation, get up and running with these steps.

1

Configure your API keys

Run the interactive setup wizard to configure your LLM and search providers.

$ termiflow config init

You'll be prompted for:

OpenAI API key (or Anthropic/local LLM)
Tavily API key (for web search)

2

Ask your first question

Query anything and get AI-powered answers with sources.

$ termiflow ask "what are the latest advances in 3nm chip fabrication?"

3

Subscribe to topics

Get curated daily updates on topics you care about.

$ termiflow subscribe "silicon-chips"

4

Check your feed

View your curated updates.

$ termiflow feed

Verify Installation

Confirm termiflow is installed correctly.

                                $
                                Terminal
                            

                            $ termiflow version

termiflow v1.0.0

  Build:      2025-01-01
  Commit:     abc1234
  Go:         go1.22.0
  Platform:   darwin/arm64
                        

✓ If you see version output, you're all set! Head over to Commands to learn what you can do.