baiagent-director README

README проекта с github.com/Balanov/baiagent-director. Одним файлом markdown: README.md.

BAIagent — a company website becomes sourced research and a measurable pilot plan, with the real application result

A free AI advisor that turns a company website, market evidence and local business documents into sourced hypotheses and a measurable pilot plan.

Capabilities · Boundaries · Install · Web audit · Русский

BAIagent first investigates what the company sells, customer feedback, competitors and market signals. It then helps define a hypothesis, actions, owners, timing, budget assumptions, a success metric and a stop condition. The Windows app also supports selected local documents and a local Qwen model without requiring a cloud model API key.

Download BAIagent 1.3.0 for Windows x64 · Release notes · Web audit · Russian documentation

SHA-256: 3ffae27317bb26b6a620ea04990b4b8ec7ddaa0457ef3e8f9b064d16dace52be

BAIagent workflow from entering a company website to a sourced hypothesis and measurable pilot, using real application screens

Real application screens: website input, research result and pilot plan.

BAIagent research result

What it does

BAIagent workflow: website, evidence, hypothesis, measurable pilot and stop condition, with an advisory rather than autonomous boundary

Sources before suggestions. Evidence remains separate from assumptions and recommendations.

Important boundaries

BAIagent is an advisor, not an autonomous employee. It does not independently execute operations in a CRM, publish changes to business systems or guarantee commercial results. A quoted source confirms that text was found; it does not prove that the source's claim is true or that an idea will be profitable.

Fresh market research requires internet access. Saved materials, selected local documents and the local desktop dialog can be used without a network connection. Public website research runs through the web research backend; local document processing and the local Qwen dialog are Windows-app capabilities, not claims about browser-based local inference.

Some websites block automated access, require JavaScript challenges or expose too little public information. In those cases the product should show a warning or an empty result rather than invent competitors, reviews or offerings. Availability of every website, country or market is not guaranteed.

Install on Windows

  1. Download the Windows x64 installer from GitHub Release 1.3.0.
  2. Verify the SHA-256 shown above if you need an integrity check.
  3. Run the installer and follow the setup steps.

The installer and application are not Authenticode-signed. Windows may therefore display an unknown-publisher warning. The package metadata identifies the author as Anton Balanov, but metadata is not a digital signature.

If no compatible local Ollama model is available, the app can download approximately 2.4 GB of model data on first use. Keep sufficient free disk space; 8 GB RAM or more is recommended.

Release 1.3.0 updates BAIagent Director only. Balanov.PRO Enterprise remains at 1.1.1 and is not rebuilt or replaced by this release.

Development

Node.js 24 and npm are required.

npm ci
npm run electron:dev

Validation and web builds:

npm test
npm run build
npm run build:xray
npm run build:advisor
npm run build:enterprise

Desktop packages:

npm run dist:win
npm run dist:linux  # on Linux
npm run dist:mac    # on macOS

The current JavaScript regression suite contains 391 tests in 31 files. Additional PHP suites cover the public research route, international extraction, market filters and sector-specific regressions. Live smoke research has been run for Atlassian in English, Correos in Spanish and Midea in Chinese; these checks are not a claim that every language, market or website has been verified.

The GitHub workflow can build Director for Windows, Linux and macOS. It does not prove manual verification on every platform, macOS notarization or Authenticode signing. The Windows artifact linked above is the verified 1.3.0 build documented in this release.

Web deployment

npm run build:xray

Deploy the contents of dist/ to /xray/ on PHP 8.1+ with cURL, DOM and SimpleXML. The browser calls /xray/api/research.php; no cloud model key is required for that route.

Repository structure

src/             React interface and research results
electron/        Isolated desktop runtime, local files and Qwen
shared/          Research, evidence, recommendations and pilots
public/api/      PHP public research backend
scripts/         Build and verification scripts
tests/           Automated regression tests
android/         Native Android prototype
docs/images/     Documentation images

Security and license

See SECURITY.md, ROADMAP.md and LAUNCH.md.

Source code: AGPL-3.0-or-later. Qwen and third-party dependencies retain their own licenses.

baiagent-director (Balanov/baiagent-director)

Ищем в базе…

Что это такое?BAIagent Director — бесплатное приложение-ИИ советник по бизнесу. Оно изучает компанию и её рынок по сайту, отделяет факты от гипотез, указывает источники и помогает составить измеримый пилотный план. Это не автономный сотрудник.
Это автономный агент, который работает с моей CRM, или просто советник?Это советник, а не автономный сотрудник: он готовит обоснованные гипотезы и пилотные планы, но сам не выполняет операции в вашей CRM.
Как запустить это на Windows?Скачайте установщик BAIagent Director 1.2.0 x64 со страницы релиза проекта на GitHub и запустите его. Отдельный установщик Balanov.PRO Enterprise 1.1.1 существует для корпоративного режима.
Нужен ли мне облачный ключ API или сначала надо установить Ollama?Облачный ключ API не нужен. Приложение работает с Qwen через уже установленный локальный Ollama или само загружает модель Qwen3-4B (около 2,4 ГБ) при первом запуске. Рекомендуются 8 ГБ и более оперативной памяти и свободное место на диске.
Есть ли подводные камни при установке, о которых стоит знать?Установщики для Windows не подписаны через Authenticode, поэтому Windows покажет предупреждение о неизвестном издателе. Кроме того, найденные в источниках цитаты лишь подтверждают, что текст есть в источнике, но не то, что утверждение верно или идея коммерчески ценна.
Это доступно только для Windows?Основное настольное приложение ориентировано на Windows и поддерживает локальные документы. При этом процесс сборки релизов также создаёт пакеты приложения Director для Linux и macOS, а для режима аудита есть отдельная веб-версия.
Остаются ли данные моей компании на моём компьютере?Документы и история диалогов хранятся и обрабатываются локально на Windows и могут использоваться без интернета. Доступ в интернет нужен только для исследования рынка в реальном времени.
Какие форматы документов приложение для Windows может читать локально?Вместе с локальным чатом оно поддерживает файлы TXT, Markdown, CSV, JSON, PDF и DOCX.
В чём разница между BAIagent, веб-аудитом и Balanov.PRO Enterprise?У них общая кодовая база, но разные точки входа и серверные настройки. BAIagent — это бесплатный локальный советник, веб-аудит работает через бэкенд на PHP, а Balanov.PRO Enterprise — расширенный корпоративный режим аудита.
Как она структурирует рекомендации?Она строит причинно-следственные гипотезы по цепочке наблюдение → механизм → действие → проверка. Вы можете выбрать или добавить свою гипотезу, прежде чем она составит пилотный план.
Какие есть похожие проекты?svoi, stemkit, SCM, yovoice, easyread, neo, get-it, TwinDesk
Автор
Balanov
Размер
6.4 MB
Звёзды
116
Возраст
21 д
Коммиты · 90 дней