⚡

# BizNode

Enter your dashboard password to continue

⚠️ BizNode is not configured yet. Please complete the setup to start working.
Dashboard BizChannel Support Tickets Monitor Services Settings
BizNode
Agent

#

Total Leads

Businesses

Pending Approvals

Active Tasks

## Recent Activity

No activity yet

## Pending Approvals

No pending approvals

## Live Activity Feed

Waiting for events…

Ask the agent anything about your business…

Name | Business | Contact | Source | Status | Created
--- | --- | --- | --- | --- | ---
No leads found

Name | Company | Email | Phone | Tags | Value | Source | Status | Actions
--- | --- | --- | --- | --- | --- | --- | --- | ---
No client files yet — create one manually or via email (send "client: ..." to your BizNode inbox)

###

Name *
Company
Email
Phone
Website
Telegram ID
Contract Value ($)
Status
Tags (comma-separated)
Address
Notes

###

Company:

Email:

Phone:

Website:

Telegram:

Address:

Value: $

Tags:

Source:

Notes

No pending approvals

ID | Type | Risk | Status | Response | Created
--- | --- | --- | --- | --- | ---
No actions yet

Name | Role | Business Type | Telegram | Email | Status
--- | --- | --- | --- | --- | ---
No associates found

Conversion Rate

Total Leads

Converted

### Lead Activity (7 days)

### Lead Status Distribution

### Agent Actions (7 days)

### Lead Sources

## 🗂 Menu Builder

Define the buttons shown to Telegram users via `/menu`.

Name | Type | Link / Task Code | Sort | Active |
--- | --- | --- | --- | --- | ---

Telegram Preview

📋 Select an option:

Workflows

Workflow Details

Code (unique ID)
Trigger Command
Description
Active

Steps

Select a workflow from the left or click "+ New".

What is the Instruction Contract?

This Markdown content is injected as system context into every LLM call — it tells the AI how to handle menus, workflows, and tasks. Edit it to customize the bot's behavior and knowledge of your workflows.

instruction.md content

###

Display Name
Type
URL
Task / Trigger Command
Sort Order

###

Step Order
Step Type
Prompt (shown to user)
Field Name (key to store answer under)

## BizNode Setup

Configure your BizNode agent below. Values are saved to `.env` in the project root. Minimum required: Telegram Bot Token + Owner Telegram ID. Click
for field details.

⚠️

### Reset All Data?

This action cannot be undone.

All knowledge notes, leads, conversations, menus, workflows, query logs, and scheduled tasks will be permanently deleted. Your .env settings and backup files are not affected.

Type `RESET` below to confirm:

## BIZNODECORE — BizChannel Marketplace

Event-driven marketplace: channel discovery, advertising, escrow payments, AI verification.

### Blockchain — Polygon (Chain 137)

BizNode Wallet: 0xb96e...afe3
Token: BZeUSD (Polygon)
Fee: 5% per transaction
Telegram Group: BizNode Bot Network

### Recent Transactions

Type | From | To | Amount | Date
--- | --- | --- | --- | ---
No transactions yet

### Discover Resource

Name | Category | Followers | Score | Price | Status | Verified
--- | --- | --- | --- | --- | --- | ---
No resources discovered yet

### New Service Request

No service requests yet

# | Buyer | Provider | Price | Fee | Status | Actions
--- | --- | --- | --- | --- | --- | ---
No orders yet

Order | Amount | Token | Status | Locked At | Released At
--- | --- | --- | --- | --- | ---
No escrow records

### Register Bot

Bot | Polygon Address | Services | Verified | Reputation
--- | --- | --- | --- | ---
No bots registered

ID | Type | Source | Status | Created
--- | --- | --- | --- | ---
No events recorded

### Create Video Task

Describe what video you want. The AI agent will generate a script, voiceover, and render the full video.

Pipeline: Script → Voiceover → Render → MP4 (10-20 min)

### Video Tasks

ID | Instruction | Source | Status | Created | Actions
--- | --- | --- | --- | --- | ---
No video tasks yet. Create one above or send /videotask via Telegram.

### Video Task Detail

###
Publish to YouTube

YouTube API Not Configured

To enable publishing:

1. Go to Google Cloud Console
2. Enable "YouTube Data API v3"
3. Create OAuth 2.0 credentials (Desktop App type)
4. Download the JSON and save as `config/youtube_client_secret.json`
5. Click "Authorize" below to complete setup

YouTube credentials found but not yet authorized. Click below to open the OAuth consent screen.

Generating title, description, and tags via AI...

### How Video Automation Works

1. Instruction
Owner sends video brief via Telegram /videotask, email with subject videotask, or this dashboard.
2. AI Script
Local LLM (Ollama) generates a structured video script with scenes, visual types, and voiceover text.
3. Voiceover
Microsoft Neural TTS (edge-tts) generates per-scene MP3 voiceover audio files.
4. Render
Pillow + moviepy renders 1920x1080 animated scenes synced with voiceover → final MP4.
5. Publish
One-click upload to YouTube with AI-generated title, description, tags, and category.

## BizNode Help & Field Guide

Everything you need to get started and understand the configuration.

## How BizNode Works

BizNode is an autonomous AI business operator. It runs as a background agent that handles lead capture, business registration, owner approvals, memory storage, and networking — all without you having to be present. You interact with it through Telegram and monitor it through this dashboard.

1. You configure

Fill in the Setup form. Save to `.env`. The agent reads credentials from there.

2. Agent operates

BizNode listens on Telegram, captures leads, stores memory in Qdrant + SQLite, and acts via Ollama LLM.

3. You monitor

This dashboard shows live activity, leads, approvals, chat, and reports. Approve or reject actions here.

## Minimum Requirements

You need two things to get the agent running:

What | Where to get it
--- | ---
`TELEGRAM_BOT_TOKEN` | Open Telegram → search @BotFather → send `/newbot` → follow the prompts → copy the token it gives you.
`OWNER_TELEGRAM_ID` | Open Telegram → search @userinfobot → send `/start` → it replies with your numeric ID (e.g. `123456789`).

## Setup Form — Field Reference

### 📡 Telegram Bot

Field | Description | Example
--- | --- | ---
`Bot Token` ★ | The secret token BizNode uses to send and receive Telegram messages as your bot. Never share this — treat it like a password. | `7123456789:AAHx…`
`Owner Telegram ID` ★ | Your personal Telegram user ID (a number). The agent uses this to send you notifications and verify that commands come from you. | `123456789`

### 🧠 Ollama / LLM

BizNode uses Ollama to run AI models locally — no cloud API keys needed. Install Ollama, pull a model, and point BizNode to it.

Field | Description | Default
--- | --- | ---
`LLM Endpoint` ★ | Full URL to Ollama's text generation API. Leave as default if Ollama runs on the same machine. | `http://localhost:11434/api/generate`
`Embeddings Endpoint` | URL for Ollama's embedding API. Used to convert text to vectors for semantic memory search. | `http://localhost:11434/api/embeddings`
`LLM Model Name` ★ | The model BizNode thinks and writes with. Must be pulled first: `ollama pull qwen2.5` | `qwen2.5`
`Embedding Model` | Model for generating semantic embeddings. Pull with: `ollama pull nomic-embed-text` | `nomic-embed-text`

Quick start: Install Ollama from ollama.com, then run:
`ollama pull qwen2.5` `ollama pull nomic-embed-text`

### 🗄️ Qdrant Vector DB

Qdrant stores the agent's semantic memory — everything it has learned about leads, businesses, and notes. It enables "remember when…" style recall.

Field | Description | Default
--- | --- | ---
`Qdrant Host` | Hostname where Qdrant is running. Use `localhost` for local installation or Docker. | `localhost`
`Qdrant Port` | TCP port for Qdrant's REST API. Default is 6333 unless you changed it in Docker. | `6333`

Run Qdrant with Docker:
`docker run -p 6333:6333 qdrant/qdrant`

### 📧 Email / SMTP

Optional. Lets the agent send email notifications and outreach on your behalf.

Field | Description
--- | ---
`Agent Email` | The "From" address BizNode uses. This is the email your contacts will see.
`SMTP Host` | Your email provider's SMTP server. Gmail: `smtp.gmail.com`
`SMTP Port` | 587 for STARTTLS (most providers), 465 for SSL/TLS.
`SMTP Username` | Your email address used to log in to the SMTP server.
`SMTP Password` | For Gmail: generate an App Password (Google Account → Security → App Passwords). Do not use your main Gmail password.
`Owner Email` | Where the agent sends you owner-level notifications and alerts.

### 🔐 Security

Field | Description
--- | ---
`Node Password` | Used to encrypt the node's cryptographic identity keys. Set it once and do not change it — changing it requires re-generating the identity.
`Audit Signing Key` | Secret used to sign every audit log entry. Change from the default for a production deployment. Used to detect log tampering.

### ⚙️ Advanced

Field | Description
--- | ---
`SQLite Database Path` | Path to the SQLite database file relative to the project root. Only change this if you want the database in a custom location (e.g. on a USB drive or network share).

## Dashboard Sections

Section | What it shows
--- | ---
⚡ Dashboard | Service health pills, metric cards (leads, businesses, tasks, approvals), recent activity list, and a pending-approvals queue with inline Approve / Reject buttons.
📡 Activity Feed | Real-time stream of every agent action via WebSocket. Color-coded by event type. Pause/resume toggle to freeze the stream while you read.
💬 Chat | Conversational interface backed by the RAG agent. Ask the agent to summarise leads, explain a decision, or search memory. Requires Ollama to be running.
🎯 Leads & Actions | Full leads table with status badges. Pending approvals tab for reviewing risky actions. Action history with approve/reject outcome.
🌐 Network | Table of registered 1bz associate partners with role filter.
📊 Reports | Charts for lead activity trend, status distribution, agent action frequency, and lead sources.
⚙️ Setup | This configuration form. Saves to `.env` in the project root.

## Starting the Full Agent (after Setup)

Once configured, start the Telegram bot agent from the project root:

# 1. Make sure Ollama and Qdrant are running

ollama serve

docker run -p 6333:6333 qdrant/qdrant

# 2. Start the BizNode agent

python boot.py

# 3. Keep this dashboard running separately

python run_dashboard.py

## Troubleshooting

Problem | Fix
--- | ---
Telegram Test says "Unauthorized" | The bot token is wrong or incomplete. Re-copy it from @BotFather — make sure there are no spaces.
Ollama Test fails | Run `ollama serve` in a terminal. Check the URL matches what you entered.
Qdrant Test fails | Start Qdrant: `docker run -p 6333:6333 qdrant/qdrant`
Chat returns an error | langgraph or Ollama is not running. Both must be installed and the model must be pulled.
No leads showing | The agent hasn't processed any messages yet. Send a message to your Telegram bot first.
Dashboard shows "Not configured" | Go to Setup, fill in at minimum Bot Token + Owner ID, click Save.

## Scheduled Tasks

Create Task

Name
Type
Cron Expression (or leave blank)
Interval (seconds) (or leave blank)
Action JSON

Name | Type | Schedule | Status | Last Run | Runs | Actions
--- | --- | --- | --- | --- | --- | ---
No tasks yet. Click "+ New Task" to create one.

## MCP Capability Keys

Generate MCP Key

Issue To (Telegram ID / email / node_id)
Permission
Task (leave blank for node-wide)
Expires (days)

Token generated — copy it now:

``

Issued To | Permission | Task / Scope | Status | Expires | Last Used | Actions
--- | --- | --- | --- | --- | --- | ---
No keys yet.

Verify Token

✓ Valid token

✗

This Node

Node ID

``

Display Name

Public Key (first 32 chars)

``

Endpoint

Capabilities

Scan to import this node

## Trusted Peers

Paste Identity Card JSON

Name | Node ID | Endpoint | Last Seen | Actions
--- | --- | --- | --- | ---
No peers yet. Add one above.

## 🧠 Knowledge Base

Add business knowledge — the AI chat will automatically use it for accurate answers

Title (required for paste; auto-filled from filename for uploads)
Business Knowledge Content

💡 What happens when you click "Add"?

1. Ollama summarizes your content to 3 key lines

2. Ollama extracts 5 business tags automatically

3. 768-dim vector embedding is generated and stored in Qdrant

4. Semantically similar existing notes are auto-linked

5. The chat window immediately starts using this knowledge for RAG responses

📄

Click to choose or drag & drop a file

Supported: .txt · .md · .pdf · .docx

✅

The file content goes through the same pipeline as pasted text — summarize → tag → embed → store.

🔍

## 💾 Backup & Recovery

📥 Download Key
🔐

Encryption key fingerprint: ``

⚠ Download and store your key securely. Without it, backups cannot be restored.

Last backup:
Global Schedule (cron)
Retention (backups to keep)

💿 Local

backups/ folder on device

Last:

☁ Google Drive

OAuth2 authenticated upload

Last:

| Connect OAuth

📦 Dropbox

Personal access token

Last:

🪣 AWS S3

Any S3-compatible bucket

Last:

🖧 NAS / Network Path

Copy to any mounted path

Last:

🪟 OneDrive

Coming Soon

—

###

### Backup History

Date / Time | Provider | File | Size | Status
--- | --- | --- | --- | ---

Next scheduled backup: UTC

## 📣 Marketing Hub

Customer queries, blocklist management, and email instruction processing.

Queries today
Unique customers
Blocked
Emails sent today
Emails received today
No queries found.

### Block a Customer

No blocked customers — all clear!

Telegram ID | Reason | Blocked by | Date | Action
--- | --- | --- | --- | ---

Last checked: Not checked this session. Scheduled: every 15 min
📨 How to send instructions via email

Reply to your daily digest email with any of these commands (one per line):

`block 123456789 reason: spam` `unblock 987654321` `add: We now offer premium support at $299/month including priority response` `delete: Old Pricing 2024`

You can include multiple instructions in a single reply — BizNode processes all of them within 15 minutes.

No email instructions processed yet.

Date | Parsed Action | Status | Result
--- | --- | --- | ---

No sent emails recorded yet.
Emails are logged automatically when the system sends digest, lead notifications, or approval requests.

Date / Time | Type | To | Subject | Preview | Status
--- | --- | --- | --- | --- | ---

ℹ Received emails are owner reply-emails fetched from IMAP every 15 minutes. Customer messages arrive via Telegram — see the
tab.
No received emails logged yet.
Owner reply-emails are captured when you click "Check Inbox" or on the 15-minute schedule.

Date / Time | Type | From | Subject | Preview / Actions Taken
--- | --- | --- | --- | ---

## 🤝 Affiliate Links

Manage partner links shown to customers via bot and emails.

Total Links
Active
Total Clicks

Title | URL | Category | Commission | Clicks | Active | Actions
--- | --- | --- | --- | --- | --- | ---
No affiliate links yet. Click "+ Add Link" to create one.

Customers can view these links via the `/affiliate` bot command. Links are also included in promotional emails when enabled.

###

Title *
URL *
Description
Category
Commission