Skip to content

terraphim/homebrew-terraphim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 

Repository files navigation

Homebrew Tap for Terraphim AI

This is the official Homebrew tap for Terraphim AI tools.

Installation

# Add the tap
brew tap terraphim/terraphim

# Install tools
brew install terraphim-server   # HTTP API server
brew install terraphim-agent    # Interactive TUI/REPL

Available Formulas

Formula Description
terraphim-server Privacy-first AI assistant HTTP server with semantic search
terraphim-agent Interactive TUI and REPL for semantic knowledge graph search

Usage

Terraphim Server

# Start the server
terraphim_server

# Run as a background service
brew services start terraphim-server

# Check status
brew services info terraphim-server

The server will be available at http://localhost:8000.

Terraphim Agent (TUI)

# Start interactive REPL
terraphim-agent

# Available commands:
# /help           - Show all commands
# /search "query" - Semantic search
# /chat "message" - AI conversation

Configuration

Configuration files are installed to:

  • Server: $(brew --prefix)/etc/terraphim/

Updating

brew update
brew upgrade terraphim-server terraphim-agent

Building from HEAD

To install the latest development version:

brew install --HEAD terraphim-server
brew install --HEAD terraphim-agent

Troubleshooting

Build fails with OpenSSL errors

Ensure OpenSSL is properly linked:

brew reinstall openssl@3
export PKG_CONFIG_PATH="$(brew --prefix openssl@3)/lib/pkgconfig"
brew reinstall terraphim-server

Gatekeeper blocks execution (unsigned binaries)

Current builds are unsigned. To allow execution:

# Right-click the app and select "Open", or:
xattr -d com.apple.quarantine $(which terraphim_server)

Note: Signed and notarized binaries are coming soon!

Links

License

Apache-2.0

About

Homebrew tap for Terraphim AI tools

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages