Enhance KBNet setup and functionality

- Updated README.md to include links for online trial, self-host pack, demo video, and project article.
- Modified extractItem function in mark.tsx to return itemConfig.text for IDs shorter than 5 characters.
- Changed summary generation logic in summary-content.tsx to use completedAt instead of requestedAt.
- Adjusted auth.ts to disable signup based on SELF_HOST variable.
- Simplified toast notifications in wsHandler.ts.
- Removed mindsdb-js-sdk dependency from package.json.
- Refactored MindsDB query handling in server API to use local runMindsDBQuery function.
- Updated generateMapSummary function to handle query results correctly.
- Replaced MindsDB connection logic with fetch-based implementation in minds.ts.
- Cleaned up seed scripts and added configuration management for MindsDB.
- Enhanced Makefile for clearer setup instructions and added seeding process.
- Created comprehensive self-host setup guide in self-host/README.md.
- Updated docker-compose.yml to use official Docker images for platform and server.
- Added seeding scripts and configuration for MindsDB in self-host/seed directory.

Author: PriyanshuPz

README.md

@@ -9,6 +9,14 @@
 
 KBNet is an interactive learning platform that creates dynamic, AI-powered knowledge maps for users to explore topics in an engaging and intuitive way. The project uses MindsDB for AI capabilities and follows a modern web architecture.
 
+## Try KbNet
+
+- **Online Trial**: Experience KbNet at [https://kbnet.diybuilds.tech/](https://kbnet.diybuilds.tech/)
+- **Self-Host Pack**: Download the latest self-host pack from our [GitHub releases](https://github.com/PriyanshuPz/kbnet/releases) and read setup instructions in the [`self-host/README.md`](./self-host/README.md) file.
+
+- **Demo Video**: Watch KbNet in action on [YouTube](https://youtu.be/AZJZm--uAKg)
+- **Project Article**: Learn about the development and vision behind KbNet in our [detailed article](https://dev.to/priyanshuverma/mindsdb-made-it-easy-i-made-it-hard-building-an-ai-powered-knowledge-map-d0g)
+
 ## Core Features
 
 ### 1. Knowledge Map Exploration

apps/platform/src/components/map/mark.tsx

@@ -54,6 +54,10 @@ function extractItem(content: string) {
 
   if (match) {
     const [_, itemConfig] = match;
+    const id = content.split(":")[1];
+    if (id.length < 5) {
+      return itemConfig.text;
+    }
     return `${itemConfig.text}(${itemConfig.url}${content.split(":")[1]})`;
   }
 

apps/platform/src/components/summary/summary-content.tsx

@@ -42,7 +42,7 @@ export function MapSummaryContent({ mapId, initialData }: SummaryContentProps) {
   function canGenerateSummary() {
     if (!isEnabled || SELF_HOST) return false; // Can't generate if disabled or self-hosted
     if (!summaryData) return true; // No summary data means we can generate
-    const lastGenerated = summaryData.requestedAt;
+    const lastGenerated = summaryData.completedAt;
     if (!lastGenerated) return true; // No previous generation means we can generate
     const now = new Date();
     const hoursSinceLast =

apps/platform/src/lib/auth.ts

@@ -5,6 +5,7 @@ import { customSession, username } from "better-auth/plugins";
 import { bearer } from "better-auth/plugins";
 import { anonymous } from "better-auth/plugins";
 import { getUserById } from "./data";
+import { SELF_HOST } from "./utils";
 
 const restrictedUsernames = [
   "admin",
@@ -42,7 +43,6 @@ const restrictedUsernames = [
   "adminpanel",
 ];
 
-const ENABLE_SIGNUP = process.env.ENABLE_SIGNUP === "true";
 export const auth = betterAuth({
   database: prismaAdapter(prisma, {
     provider: "postgresql",
@@ -58,7 +58,7 @@ export const auth = betterAuth({
         username: profile.login.replaceAll("-", "_"),
         displayName: profile.name || profile.login,
       }),
-      disableSignUp: !ENABLE_SIGNUP,
+      disableSignUp: SELF_HOST,
     },
   },
   plugins: [

apps/platform/src/lib/wsHandler.ts

@@ -63,7 +63,7 @@ export async function wsHandler(
         state.setState("idle");
         state.setError(null);
         playFeedback("level_up");
-        toast.info(message, {
+        toast(message, {
           style: {
             maxWidth: "400px",
             whiteSpace: "normal",

apps/server/package.json

@@ -13,7 +13,6 @@
     "@kbnet/db": "*",
     "@kbnet/shared": "*",
     "@paralleldrive/cuid2": "^2.2.2",
-    "mindsdb-js-sdk": "^2.3.2",
     "better-auth": "^1.2.9",
     "ai": "^4.3.16",
     "dotenv": "^16.5.0",

apps/server/src/api/index.ts

@@ -4,8 +4,8 @@ import { Hono } from "hono";
 import { generateMapSummary } from "../controllers/summary";
 import { authClient } from "../lib/auth-client";
 import { userSettings } from "../controllers/user";
-import { runMindsDBQuery } from "@kbnet/shared/mindsdb";
 import { MindsDBConfig } from "@kbnet/shared";
+import { runMindsDBQuery } from "../lib/minds";
 
 const router = new Hono<{
   Variables: {
@@ -45,7 +45,7 @@ router.post("/maps/trigger/summary", async (c) => {
     }
 
     // limit it to one summary generation one time in 24 hours
-    const lastGenerated = map.latestSummary?.requestedAt;
+    const lastGenerated = map.latestSummary?.completedAt;
     if (lastGenerated) {
       const now = new Date();
       const hoursSinceLast =
@@ -127,6 +127,22 @@ router.post("/assistant", async (c) => {
       return c.json({ error: "Invalid messages format" }, 400);
     }
 
+    try {
+      const q = await runMindsDBQuery(`SELECT 1 as ok;`);
+      if (q[0].ok !== 1) {
+        return c.json(
+          { error: "Sorry, We don't have MindsDB up at the moment." },
+          403
+        );
+      }
+    } catch (error) {
+      console.error("MindsDB connection error:", error);
+      return c.json(
+        { error: "Sorry, We don't have MindsDB up at the moment." },
+        403
+      );
+    }
+
     const node = await prisma.node.findUnique({
       where: { id: currentNodeId },
       include: {
@@ -157,19 +173,14 @@ router.post("/assistant", async (c) => {
       ${messages.map((msg, index) => `Message ${index + 1} from ${msg.role}: ${msg.content[0].text}`).join("\n")}
       `;
 
-    // FROM ${MindsDBConfig.MAIN_NODE_GEN_MODEL}
     const query = await runMindsDBQuery(`
-      SELECT answer
-      FROM gen_main_node_model
-      WHERE question = '${prompt.replace(/'/g, "''")}';
-      `);
-
-    if (query.type != "table") {
-      return c.json({ error: "Failed to get response from MindsDB" }, 500);
-    }
+          SELECT answer
+          FROM ${MindsDBConfig.MAIN_NODE_GEN_MODEL}
+          WHERE question = '${prompt.replace(/'/g, "''")}';
+          `);
 
     const answer =
-      query.rows[0]?.answer ||
+      query[0]?.answer ||
       "I'm sorry, I don't have an answer for that at the moment.";
 
     return c.json({ text: answer });

apps/server/src/controllers/summary.ts

@@ -1,11 +1,9 @@
 import { MindsDBConfig } from "@kbnet/shared";
-import { connectMindsDB, runMindsDBQuery } from "@kbnet/shared/mindsdb";
 import { prisma } from "@kbnet/db";
+import { runMindsDBQuery } from "../lib/minds";
 
 export async function generateMapSummary(mapId: string) {
   try {
-    await connectMindsDB();
-
     const map = await prisma.map.findUnique({
       where: { id: mapId },
       include: { latestSummary: true },
@@ -22,11 +20,11 @@ export async function generateMapSummary(mapId: string) {
       LIMIT 1;
     `);
 
-    if (query.rows.length === 0) {
+    if (query.length === 0) {
       throw new Error("No summary generated by MindsDB");
     }
 
-    const summaryRecord = query.rows[0];
+    const summaryRecord = query[0];
     const summaryText = summaryRecord?.answer;
 
     if (!summaryText) {

apps/server/src/index.ts

@@ -7,8 +7,8 @@ import { authClient, tokenToSession } from "./lib/auth-client";
 import { createServer } from "http";
 import { MessageType, pack } from "@kbnet/shared";
 import { serve } from "@hono/node-server";
-import { connectMindsDB, runMindsDBQuery } from "@kbnet/shared/mindsdb";
 import { prisma } from "@kbnet/db";
+import { runMindsDBQuery } from "./lib/minds";
 
 config();
 
@@ -25,15 +25,14 @@ app.get("/", async (c) => {
   let isMindsDB = false;
   let isDB = false;
   try {
-    const cell = await runMindsDBQuery(`SELECT 1`);
-    console.log("MindsDB cell result:", cell.type);
-    if (cell.type == "table") {
+    const cell = await runMindsDBQuery(`SELECT 1 as ok`);
+
+    if (cell[0].ok === 1) {
       isMindsDB = true;
     } else {
-      isMindsDB = false;
+      console.error("MindsDB query did not return expected result.");
     }
   } catch (error) {
-    isMindsDB = false;
     console.error("Failed to connect to MindsDB");
   }
 

apps/server/src/lib/ai.ts

@@ -40,7 +40,7 @@ export async function generateMapStartPoint(
 
     const { object } = await generateObject({
       model: google("gemini-2.0-flash"),
-      system: MAIN_NODE_GEN_MODEL_PROMPT(query, kbdata.rows),
+      system: MAIN_NODE_GEN_MODEL_PROMPT(query, kbdata),
       schema: z.object({
         mainNode: z.object({
           title: z