# BizNode Basic -- AI Business Automation Node

**Version:** 1.2.0
**License:** Apache 2.0
**Price:** $200 (one-time purchase)

BizNode(TM) is an AI-powered business automation node that runs entirely on your Windows machine. It provides a Telegram bot for customer interaction, a local dashboard for management, a RAG knowledge base for intelligent responses, and LLM-powered chat -- all under your control, with no cloud dependency.


## Core Features

| # | Feature | Description |
|---|---------|-------------|
| 1 | **Telegram Bot** | 1 bot instance for customer interaction and owner commands |
| 2 | **Dashboard** | Web-based management interface on port 7777 |
| 3 | **RAG Knowledge Base** | Qdrant vector database on port 6333 for intelligent document retrieval |
| 4 | **LLM Chat** | Ollama-powered AI on port 11434 (model: qwen3.5:4b) |
| 5 | **Email Service** | SMTP-based email for notifications and customer communication |
| 6 | **OTP Verification** | One-time password system for secure actions |
| 7 | **Workflow Engine** | Automated task execution and business logic |
| 8 | **Local Backup** | On-demand backup of database and vector store |


## Architecture

- **Qdrant** runs inside Docker (requires Docker Desktop)
- **Ollama** and the **Telegram Bot** run as native Windows processes
- **Dashboard API** is a FastAPI server running locally
- **Database** defaults to SQLite (upgradeable to PostgreSQL)


## Quick Start

```
python setup_wizard.py
```

Edit the generated `.env` file with your Telegram bot token and business details, then:

```
python service_manager.py start
```

Open `http://localhost:7777` in your browser to access the dashboard.

See [INSTALL.md](INSTALL.md) for the full installation guide.


## Key Entry Points

| File | Purpose |
|------|---------|
| `setup_wizard.py` | First-time setup -- installs dependencies, pulls AI models, configures database |
| `launcher.py` | Launches all services in one step |
| `bot_runner.py` | Starts the Telegram bot independently |
| `service_manager.py` | Start, stop, restart, and check status of all services |


## Folder Structure

```
basic/
  automation/       Workflow engine and scheduled tasks
  backup/           Local backup scripts
  config/           Configuration files
  core/             Core business logic
  datavault/        DataVault report marketplace (consumer)
  docker/           Docker Compose and bot source
  identity/         Node identity and keys
  logos/             Branding assets
  memory/           Database adapters and storage
  scripts/          Utility and migration scripts
  services/         Email, OTP, license, and other services
  tools/            Helper tools
  ui/               Dashboard frontend and API server
```


## System Requirements

- **OS:** Windows 10 or Windows 11
- **Python:** 3.10 or higher
- **Docker Desktop:** Required for Qdrant vector database
- **RAM:** 8 GB minimum
- **Disk:** 5 GB free space recommended


## Upgrade to Pro

BizNode Pro ($499) adds advanced capabilities on top of Basic:

- BizChannel decentralized ad marketplace
- Multi-bot support (up to 5 bots)
- Crypto payments (BZeUSD on Polygon)
- Affiliate and engagement system
- BizBrain AI agent intelligence
- Cloud backup to Google Drive
- Node network monitoring
- API access
- Priority support

Contact biznodesupport@1bz.biz for upgrade details.


## Support

Email: biznodesupport@1bz.biz

For common issues, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md).


## Legal

Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full text.

BizNode is a trademark of 1BZ DZIT DAO LLC. See [TRADEMARK.md](TRADEMARK.md) for trademark policy.
