hz README

The project's README from github.com/danielvaughn/hz. As one markdown file: README.md.

Huzzah

An experimental interface for building software by editing persistent pseudocode and synchronizing it with an AI-generated implementation.

setup

You need Node.js 22.19 or newer and access to a model provider supported by Pi.

  1. git clone https://github.com/danielvaughn/hz.git
  2. cd hz
  3. npm install
  4. Configure Pi using one of the options below.
  5. npm run dev

Open the url (should run on http://localhost:5173)

configure Pi

Huzzah uses Pi's provider, credential, and model configuration. It does not require a particular model vendor.

authenticate with an API key

Set an environment variable supported by your provider before starting Huzzah. For example:

export ANTHROPIC_API_KEY=sk-ant-...

Pi also recognizes credentials for OpenAI, Google, Azure OpenAI, Amazon Bedrock, and other supported providers.

authenticate with a subscription

Run Pi through the web app's local installation:

npx --workspace=poc pi

Enter /login, choose a provider, and complete its authentication flow. Exit Pi when authentication is complete, then start the web app with npm run dev.

choose a model

Set Pi's default provider and model in ~/.pi/agent/settings.json:

{
  "defaultProvider": "anthropic",
  "defaultModel": "claude-sonnet-4-5"
}

Use model IDs available to your configured provider. If no default is set, Pi falls back to the first authenticated model it finds. Huzzah currently uses Pi's low thinking level for reconciliation and semantic highlighting regardless of defaultThinkingLevel.

Pi also supports custom providers and local models such as Ollama, LM Studio, and vLLM through ~/.pi/agent/models.json.

Do not paste secrets or private source into Huzzah. Specs and current generated source are sent to your selected model provider, and accepted AI-generated JavaScript runs locally in a Web Worker. This is experimental containment, not a hostile-code sandbox.

ideas to get started

hz (danielvaughn/hz)

Searching Database…

201 ·GitHub
Что это?Huzzah («hz») — экспериментальный редактор, в котором вы пишете постоянную спецификацию на псевдокоде, а ИИ непрерывно держит синхронизированную с ней реализацию на JavaScript, так что вы создаёте ПО, редактируя спецификацию вместо кода.
Это редактор кода вроде VS Code или нечто иное?Это другая парадигма: вы правите спецификацию на псевдокоде, а ИИ заново генерирует и согласует соответствующую реализацию на JavaScript, которая выполняется локально в Web Worker, а не пишется вручную.
Как его запустить?Склонируйте репозиторий, выполните npm install, настройте параметры провайдеров и учётных данных Pi, затем выполните npm run dev, чтобы открыть веб-приложение в браузере.
Что нужно перед пробой?Нужны Node.js 22.19 или новее и доступ к любому провайдеру моделей, поддерживаемому Pi — авторизация через API-ключ (OpenAI, Google, Azure OpenAI, Amazon Bedrock и т.д.), вход по подписке или локальная модель вроде Ollama, LM Studio или vLLM.
Надёжно ли изолируется сгенерированный ИИ код?Не полностью — запуск сгенерированного кода в Web Worker описан как экспериментальное сдерживание, а не настоящая изоляция от враждебного кода, поэтому полагаться на него как на границу безопасности не стоит.
Для кого это?Он рассчитан на разработчиков, которым интересен опосредованный ИИ способ написания ПО «сначала спецификация» вместо традиционного ручного кодирования.
Он работает в браузере или есть и десктопное приложение?Он работает прежде всего как веб-приложение, открываемое через npm run dev, а в репозитории есть и сборка Electron (dev:electron, build:electron) для десктопной версии.
Отправляется ли моя спецификация или код куда-либо?Да — ваши спецификации и текущий сгенерированный код отправляются тому провайдеру моделей, которого вы настроили, поэтому README предупреждает не вставлять в Huzzah секреты или закрытый исходный код.
Что такое Pi?Pi — слой конфигурации провайдеров, учётных данных и моделей, на который опирается Huzzah; он абстрагирует конкретного ИИ-вендора, позволяя Huzzah работать со множеством разных провайдеров и локальных моделей.
Какие проекты README предлагает попробовать?Небольшие приложения с чётко очерченной логикой: корзину покупок с правилами скидок, пошаговую боевую систему, трекер бюджета, ограничитель частоты запросов и игру в слова — хорошие тестовые случаи для процесса «от спецификации к коду».
Нужна ли конкретная модель или вендор ИИ?Нет — Huzzah не требует конкретного вендора моделей; нужен лишь любой поддерживаемый Pi, а если модель по умолчанию не задана, берётся первая авторизованная.
Можно ли использовать локальную модель вместо облачного API?Да, Pi поддерживает кастомных провайдеров и локальные модели вроде Ollama, LM Studio и vLLM, настраиваемые через ~/.pi/agent/models.json.
Size
0.3 MB
Stars
201
Updated
CommitAug 23
Age
2mo
Commits · 90 Days