Early Access

glashaus-console

Interactive terminal agent for Glashaus. Upload files, manage domains, and check analytics — via natural language or slash commands. Supports any OpenAI-compatible LLM, Anthropic, and Ollama.

Testing release — not yet on npm

The console is functional and actively used for testing the Glashaus API. Clone the repo to try it. A standalone npm release is planned once the agent stabilises.

Quick Start

Clone the repository and install dependencies from the root

bash

git clone https://github.com/glashaus-xyz/glashaus && cd glashaus && npm install

Enter the package and run the setup wizard

bash

cd packages/glashaus-console && npm run setup

Launch the agent

bash

npm run agent

Setup Wizard

Run npm run setup once. It walks through three things:

API URL

Defaults to https://glashaus.xyz. Use http://localhost:3000 for local dev.

Wallet

Generate a fresh EVM wallet or import an existing private key. Stored in a local .env file.

LLM Provider

Pick OpenAI, Groq, Anthropic, Ollama, or any OpenAI-compatible endpoint.

LLM Providers

The console sends ~1,500 tokens of tool schemas per request. Use a model with a high tokens-per-minute limit. Groq is recommended — free tier, no credit card required.

Groq

Recommended

Recommended — generous free tier

LLM_PROVIDER=openai
LLM_API_KEY=gsk_...
LLM_BASE_URL=https://api.groq.com/openai/v1
LLM_MODEL=llama-3.1-8b-instant

Anthropic

Claude models

LLM_PROVIDER=anthropic
LLM_API_KEY=sk-ant-...
LLM_MODEL=claude-haiku-4-5-20251001

Ollama

Local models, no API key

LLM_PROVIDER=openai
LLM_BASE_URL=http://localhost:11434/openai/v1
LLM_MODEL=llama3.2

OpenAI

Standard OpenAI API

LLM_PROVIDER=openai
LLM_API_KEY=sk-...
LLM_MODEL=gpt-4o-mini

Slash Commands

Handled directly — no LLM call, no tokens consumed.

Command	Description
/upload <path> [ttl]	Upload a file or folder to IPFS (TTL in days, default 30)
/stats	Total files, storage used, and estimated cost
/files [limit]	List pinned files with expiry info
/analytics <cid> [days]	Traffic stats for a CID
/wallet	Wallet address and GitHub free-tier status
/github [token]	Check or link GitHub for 100 MB free storage
/domain	List custom domains
/domain add <cid> <domain>	Point a domain at a CID
/pricing [sizeMB] [days]	Show storage rates
/setup	Rerun the setup wizard (wallet, LLM, API URL)
/help	Show all available commands

Natural Language

Anything that isn't a slash command goes to the LLM. Examples:

Upload ~/Desktop/my-site to IPFS for 30 days

Deploy ~/Desktop/tetris as a website

How many files have I uploaded?

Point mydomain.com at bafybeiabc123...

What's the traffic on bafybeiabc123 this week?

Link my GitHub account for the free tier

Free Tier

Link your GitHub account once to unlock 100 MB/day of free 1-day pins — no USDC needed.

Run /github to check link status
Run /github <your-PAT-token> to link
Or just ask: "Link my GitHub account"

View on GitHub API Reference →