Install BizNode
Before you begin — install these first
Python 3.10+
Download from python.org. During install, tick "Add Python to PATH" — this is critical.
Docker Desktop
Download from docker.com. Start Docker Desktop and keep it running before launching BizNode.
Windows 10 / 11
8 GB RAM minimum. 15 GB free disk space (for AI models ~2.5 GB + data).
Installation steps
Download from biznode.1bz.biz and extract to a folder such as C:\BizNode
Double-click setup.bat in the extracted folder. This installs Python packages, downloads the AI model (~2.5 GB — takes 10–20 min), and starts Qdrant.
Copy .env.example to .env. Fill in your Telegram bot token and Telegram user ID (see Section 2).
Run start.bat — or open a terminal and type python launcher.py. A 10-day free trial starts automatically.
Visit http://localhost:7777 in your browser. This is your owner control panel.
Create Your Telegram Bot
Your BizNode talks to customers through a Telegram bot. You create this bot for free — it takes 2 minutes.
Step 1 — Get your bot token from BotFather
BotFather is Telegram's official bot manager. Click Start.
BotFather will ask for a name and then a username. The username must end in "bot" (e.g. MyShopBot).
BotFather sends a token like 1234567890:ABCDefghIJKlmnopQRST — copy and save this. You will paste it in the .env file and dashboard.
Step 2 — Find your Telegram User ID
Send it any message. It replies with your numeric User ID, e.g. 987654321.
This ID is your "OWNER_TELEGRAM_ID". BizNode uses it to know who the owner is and give you admin access.
Step 3 — (Optional) Set Up Telegram Group Monitoring
If you have a Telegram community group, BizNode can silently capture every member as a lead and respond intelligently when @mentioned in the group.
Add @userinfobot to your group temporarily — it will print the group's chat ID (a negative number like -1003710628018). Remove it after.
Your BizNode bot must be a member (and preferably admin) of the group so it can read messages.
Add TELEGRAM_GROUP_ID=-1003710628018 (your group's ID) to your .env file, then restart the bot. Group monitoring activates automatically.
See it in action in the BizNode Community Group — members' questions are answered live by the AI bot.
source=telegram_group. @mentioning the bot triggers a full RAG answer. Group activity appears in your daily digest email.
Configure the Dashboard
The Setup screen at localhost:7777 — configure your bot token, Ollama endpoint, and business details here.
Open http://localhost:7777 and go to the Setup section.
Telegram Bot Token
Paste the token from BotFather here.
Owner Telegram ID
Paste your numeric ID from @userinfobot.
Business Name
Your business name — the bot introduces itself with this.
Business Description
What your business does. The AI uses this to answer customer questions.
LLM Model
Default: qwen3.5:4b — works on 8 GB RAM with no GPU.
Dashboard Password
Optional — set a password to protect your dashboard from others on the network.
After filling in your settings, click Save Settings and then Restart Bot.
Set Up Your Knowledge Base
The Knowledge Base screen — paste your business info or upload a .txt / .md file. The AI summarises it and stores it as a searchable memory.
The knowledge base is how your bot knows about your business. When a customer asks a question, the bot searches your knowledge base first and answers from it. This makes responses accurate and specific to your business.
Method 1 — Seed from Business Profile (Recommended for first setup)
Fill in your business name, type, description, products/services, pricing, and working hours.
BizNode embeds your business profile into the AI memory. The bot can now answer questions about your business.
Method 2 — Use BizBrain (Recommended)
Send /help to your bot in a private Telegram chat. BizBrain asks 4 questions and generates a full business profile with FAQs, services, target audience, and growth strategy. Copy the sections into your knowledge base — it's the fastest way to train your bot accurately.
Method 3 — Upload a text or markdown file
In the Knowledge Base section of the dashboard, upload a .txt or .md file with information about your products, FAQs, policies, or anything customers might ask about.
Method 4 — Type it directly
Use the "Add Text Note" form in the Knowledge Base section to type or paste content directly. Give it a title and click Add.
Example knowledge base entries
Title: Products and Pricing We sell handmade leather wallets. - Classic Wallet: $45 (black, brown, tan) - Card Holder: $25 (5 card slots) - Passport Cover: $38 All items ship within 2 business days.
Title: Shipping Policy We ship worldwide. - Domestic (USA): Free shipping on orders over $50, otherwise $5.99 - International: $15 flat rate, 7-14 business days - Tracking provided for all orders via email
BizBrain — AI Business Profiler
BizBrain is BizNode's AI-powered business intelligence profiler. Send /help to your bot in a private chat and it asks you 4 questions — then generates a comprehensive business knowledge profile tailored to your business, automatically.
4 Quick Questions
- What type of business do you run?
- What services or products do you offer?
- Who is your target audience?
- What are your main business challenges?
Profile Sections Generated
- Business Overview
- Target Audience
- Key Services
- FAQs
- Workflow Triggers
- Recommended Menu Items
- Growth Strategy
Profile Delivery
Licensed users receive the full profile by email automatically after completing the 4-question intake.
Trial users see a preview in chat and are invited to purchase a license at 1bz.biz.
How to Use BizBrain
Open Telegram, find your BizNode bot, and send it /help. BizBrain only runs in private chat — not in groups.
Reply naturally to each question. The more detail you give, the more accurate and useful your profile will be.
The local AI model generates your profile. You'll see "Generating your BizBrain profile..." while it works.
Licensed users get the full profile emailed to their verified address. Everyone gets a preview in chat.
Use BizBrain to Seed Your Knowledge Base
Copy sections from your BizBrain profile and paste them into the Knowledge Base section of the dashboard. The FAQs, services list, and target audience sections are especially useful — they instantly train your bot to answer customer questions accurately.
Try BizBrain now — send /help to the live BizNode demo bot
🚀 Open BizNode Bot on TelegramBot Commands Reference
Customers can use these commands when chatting with your bot on Telegram.
How the AI Chat Works
The Chat section — you can ask the agent anything directly from the dashboard. Great for testing your knowledge base.
When a customer sends a message, BizNode follows this process:
The message is turned into a mathematical representation using the nomic-embed-text model.
Qdrant finds the most relevant entries from your business knowledge base.
The relevant knowledge + conversation history is sent to the local Qwen3.5 4B AI model.
The model writes a reply based on your business knowledge and conversation context. No internet required.
The customer receives the answer instantly. The conversation is logged in your dashboard.
Example conversation
Managing Leads
The Leads & Actions screen — every Telegram contact becomes a lead automatically. View name, contact, source, status, and when they were captured.
Every time someone messages your Telegram bot, BizNode captures them as a lead and stores their information automatically.
Auto Capture
Telegram username, user ID, and message history are saved automatically — no setup needed.
View in Dashboard
Go to Leads & Actions in the dashboard to see all leads, their messages, and interaction history.
Lead Status
Mark leads as new, contacted, qualified, or converted to track your sales pipeline.
Conversation Log
Full conversation history with each lead is stored. Review what the bot said and follow up manually.
Owner Dashboard Guide
The main dashboard — real-time status of Database, Qdrant, and Ollama. Plus lead counts, active tasks, recent activity, and pending approvals.
Your dashboard at http://localhost:7777 has these sections:
Email Workflow Engine
BizNode monitors your agent inbox every 15 minutes. Reply to any BizNode email — or send a fresh email to your agent address — with any of the commands below and BizNode executes them automatically, then sends you a confirmation reply.
Customer Management Commands
Blocks a customer from messaging your bot. Get their ID from Marketing Hub → Customer Queries.
block 123456789 reason: sending spam messages
Removes a customer from the block list.
unblock 123456789
Knowledge Base Commands
Adds new business knowledge. The bot will use this to answer customer questions.
add: We now offer 24/7 premium support at $199/month. Includes unlimited tickets and a dedicated Slack channel.
Removes a knowledge entry whose title contains the text you specify.
delete: Old Pricing 2024
Memory & Task Commands
Stores a persistent memory note tagged and searchable by the AI. Use a pipe (|) to separate title from body.
memory: VIP Client — Acme Corp | Acme Corp (John Lee, john@acme.com). Pays $2,000/month. Renewal due June 2026. Always prioritise their tickets.
Creates a recurring scheduled agent task. Cron format:
0 9 * * 1 = every Monday 9am UTC.
task: Weekly Sales Report | 0 9 * * 1 | send_email | Send a weekly summary of new leads and payments
Client File Command
client: name: Sarah Johnson email: sarah@techstartup.io phone: +1-555-0123 company: TechStartup Inc. website: https://techstartup.io notes: Met at SaaS Summit 2026. Interested in enterprise plan. tags: enterprise, saas, warm-lead contract_value: 12000
Confirmation Replies
After processing your instructions, BizNode sends you a green confirmation email listing each action taken with ✓ or ✗ status. All processed instructions are also visible in Marketing Hub → Email Instructions.
🔒 Sender Verification (Anti-Spoofing)
BizNode verifies every inbound email using SPF, DKIM, and DMARC checks from the Authentication-Results header before processing any instructions. Spoofed emails are rejected and logged.
How It Works
Strict Mode
OWNER_EMAIL_STRICT=true in Setup to reject emails from servers that don't add auth headers.
Default: permissive (allows emails without headers but logs a warning).
Recommended for production.
Marketing Hub — Email Reporting
The Marketing Hub gives you complete visibility into customer conversations and every email your node sends or receives. Open it from the sidebar and use the five tabs.
Customer Queries
Every Telegram message sent to your bot, with the AI's reply — searchable and filterable by date.
Blocked Customers
Customers you have blocked from the bot. Block/unblock from here or via email reply commands.
Email Instructions
Emails you sent to BizNode from your inbox that were processed as commands (add/delete/block).
Sent Emails
Every email BizNode sent — digests, lead alerts, approval requests, and agent emails — with status.
Received Emails
Emails received from your IMAP inbox that BizNode processed as owner instructions.
Sent Emails tab
BizNode automatically logs every outgoing email. The table shows:
Exact date and time the email was sent (UTC).
Colour-coded: digest (daily report), lead_notification (new lead alert), approval_request (action needs approval), agent_email (bot sent on your behalf).
First 500 characters of the email body shown as a preview. Full subject shown.
Green tick = delivered. Red cross = failed, with the error message shown inline.
Received Emails tab
Every time BizNode checks your IMAP inbox and finds an email from you (the owner), it logs it here as type owner_instruction. You can see what commands were picked up and when — useful for confirming that your reply instructions were processed.
Stats bar
At the top of the Marketing Hub, the stats bar now shows five tiles — including Emails sent today (indigo) and Emails received today (teal). These counters reset at midnight UTC each day.
Email commands via inbox reply
Reply to any BizNode email to give it instructions. BizNode checks your inbox every 15 minutes. Supported commands:
ClaudTask — Owner Instructions
ClaudTask bridges your personal Claude subscription (claude.ai) with BizNode automation. Use Claude to think through complex tasks, then save the instructions to BizNode — it executes them on schedule.
📝 How It Works
- Customer requests a service from you
- You open claude.ai (your subscription) and craft detailed instructions
- Save instructions to BizNode via Dashboard, Telegram, or Email
- BizNode runs the task on schedule and writes results
- Review results in the dashboard or result files
📱 Via Telegram
/claudtask Weekly Report | 0 9 * * 1 | llm_process | high | Acme Corp
Generate a professional weekly report covering:
1. Sales summary
2. Marketing metrics
3. Action items
Other commands: /claudtasks (list all), /claudtask_run filename.md (run now). Owner-only.
✉ Via Email
Subject:
claudtask: Weekly Report for AcmeBody: Paste instructions from Claude
BizNode detects "claudtask" in the subject, creates the task file, and sends a confirmation reply within 15 minutes.
📄 Task Types
agent_goal — Execute via the agent loop
email_send — Send email to the customer
http_call — Call an external API
Tasks can have cron schedules (e.g.,
0 9 * * 1 = Monday 9 AM) or run manually.
Multi-LLM Providers
BizNode supports three LLM backends. Switch between them by setting LLM_PROVIDER in Setup.
🤖 Ollama (Default)
qwen3.5:4b. Best for privacy-first deployments.🤖 Claude API
LLM_PROVIDER=claude and ANTHROPIC_API_KEY. Pay-per-token (~$0.002/call). Separate from claude.ai subscription.🌐 OpenRouter
LLM_PROVIDER=openrouter and OPENROUTER_API_KEY. Get a key at openrouter.ai.Tips & Best Practices
Using BizNode Telegram Bot for Business
BizNode includes a full-featured Telegram bot that handles customer onboarding, answers business questions, and silently captures leads from your community group. Here's how to get the most from it.
Step 1 — Start the Bot
Message your BizNode bot on Telegram. It will greet you and ask for your name, business, and email. After email verification you get access to the full menu and knowledge base.
➡ Open Bot on TelegramStep 2 — Join the Community Group
Join the BizNode Community Group on Telegram. Connect with other operators, share use cases, and see the bot respond to group questions in real time.
➡ Join Community GroupStep 3 — Get Your BizBrain Profile
Send /help
to the bot. It asks 4 questions about your business and generates an AI-powered
business knowledge profile. Licensed customers receive it by email.
Step 4 — Automatic Lead Capture
When you set TELEGRAM_GROUP_ID
in your .env, BizNode silently captures every group member as a lead in your CRM.
@mention the bot in the group to get AI answers without leaving the conversation.
TELEGRAM_GROUP_ID=-1003710628018 (your group's numeric ID)
in your .env file, then restart the bot. You can find your group ID by adding
@userinfobot to the group — it will print the chat ID.
Group interaction counts appear in your daily digest email.
Join the BizNode Community
Connect with other BizNode operators. Share tips, ask questions, and see the AI bot respond to group messages in real time.
Getting Support
Using /support in @biznode_bot
For node-install tiers (BizMax, BizNode, 1BZNode), use the /support command for AI-powered diagnostics:
The AI will automatically:
- Look up your registered node
- Run a remote health check via MCP
- Diagnose issues (database, AI model, dashboard)
- Attempt auto-fix (restart down services)
- Report findings and next steps
Behind NAT? Book a Support Session
If your node is behind a home router without port forwarding:
- Contact @biznode_supportbot on Telegram
- Choose a date and time
- Receive a WireGuard VPN config file
- Connect at your scheduled time
- Support team diagnoses and fixes in real-time
Support by Tier
| Tier | Support Type |
|---|---|
| Basic–BizPlus ($20–$150) | AI chat + KB search |
| BizMax ($200) | Remote MCP diagnostics + auto-fix |
| BizNode ($499) | Full support + scheduled sessions |
| 1BZNode ($1500) | Priority support + dedicated sessions |
Troubleshooting
Bot not responding on Telegram
docker compose ps — you should see bot, qdrant, and ollama as "Up".If not:
docker compose up -d
Bot says "AI is taking too long"
Dashboard not loading at localhost:7777
python run_dashboard.pyOr with Docker:
docker compose up -d dashboardQdrant not connecting in Setup
docker compose up -d qdrantMake sure the Qdrant URL in Setup is:
http://localhost:6333setup.bat errors — Python not found
Check overall status
Open a terminal in your BizNode folder and run:
python status.py
This shows registration status, trial days remaining, Docker service states, and connectivity to all services.