🤖 AIChatBot

AIChatBot is a local and online AI-powered chatbot built using open-source language models. This project supports both locally hosted models (via Ollama) and cloud-based models via OpenRouter. It demonstrates the integration of AI with a .NET 9 API and Angular 20 frontend.

---

🎬 Demo Video

Watch the AIChatBot in action on YouTube:
📺 AIChatBot Demo

---

🛠️ Prerequisites

To run this project locally, ensure the following:

• Windows 10/11 with WSL support
• Installed Ubuntu 20.04.6 LTS (via Microsoft Store)
• .NET 9 SDK
• Node.js (v20+)
• Angular CLI (npm install -g @angular/cli)
• Ollama installed in Ubuntu for running local AI models
• Optional: Account on https://openrouter.ai

---

🧱 Environment Setup (Local Models using Ollama)

1. Install Ubuntu 20.04.6 LTS

• Go to Microsoft Store → Search for Ubuntu 20.04.6 LTS → Install.
• Open Ubuntu and create your UNIX user account.

2. Install Ollama inside Ubuntu

curl -fsSL https://ollama.com/install.sh | sh

3. Pull and Run Models

To pull and run the desired models:

# Pull models
ollama pull phi3:latest
ollama pull mistral:latest
ollama pull gemma:2b
ollama pull llama3:latest

# Run models
ollama run phi3
ollama run mistral
ollama run gemma:2b
ollama run llama3

4. Manage Models

# List all pulled models
ollama list

# Stop a running model
ollama stop phi3

# View running models
ps aux | grep ollama

5. Shutdown Ubuntu

From Ubuntu terminal:

shutdown now

Or simply close the terminal window if you don’t need a full shutdown.

---

☁️ Online Models via OpenRouter

1. Go to https://openrouter.ai and sign up.

2. Navigate to API Keys in your profile and generate an API key.

3. Set this key as an environment variable in your API project:

   export OPENROUTER_API_KEY=your_key_here

4. Models used:

   • google/gemma-3-27b-it:free
   • deepseek/deepseek-chat-v3-0324:free

API requests are routed via OpenRouter using this key, supporting seamless AI chat.

---

🤖 AIChatBot Integration

🔧 Backend (API - .NET 9)

1. Navigate to AIChatBot.API/
2. Run the following commands:

dotnet restore
dotnet build
dotnet run

• Ensure appsettings.json file includes:

ApiKey=YOUR_KEY_HERE

💬 Frontend (UI - Angular 20)

1. Navigate to AIChatBot.UI/
2. Run:

npm install
ng serve

• Access the chatbot UI at http://localhost:4200/

---

🧪 Model & Environment Summary

Model	Type	Source	Access
PHI-3:latest	Local	Ollama	ollama run
Mistral:latest	Local	Ollama	ollama run
Gemma:2b	Local	Ollama	ollama run
Llama3:latest	Local	Ollama	ollama run
google/gemma-3-27b-it:free	Online	OpenRouter.ai	API Key
deepseek/deepseek-chat-v3-0324	Online	OpenRouter.ai	API Key

---

📂 Project Structure

AIChatBot/
│
├── AIChatBot.API/        # .NET 9 API for chatbot
├── AIChatBot.UI/         # Angular 20 UI frontend
└── README.md             # Project documentation

---

🧠 AI Tools & Agent Integration

The AIChatBot supports two advanced operation modes beyond simple chat:

1. 🛠️ Tool-Enabled AI

In this mode, the AI can recognize specific tasks in user prompts and use internal tools (functions) to perform actions. Integrated tools include:

Tool Function	Description	Example Prompt
CreateFile	Creates a text file with given content	"Create a file called report.txt with the text Hello world."
FetchWebData	Fetches the HTML/content of a public URL	"Fetch the content of https://example.com"
SendEmail	Simulates sending an email (console-logged)	"Send an email to john@example.com with subject Hello."

These functions are executed server-side in .NET, with input parsed from natural language prompts.

2. 🤖 AI Agent Mode (Planning + Action)

The AI agent is capable of:

• Understanding high-level tasks
• Selecting and invoking appropriate tools
• Providing intelligent responses based on the outcome

This is powered by an AgentService that works with both local LLMs (via Ollama) and cloud models (via OpenRouter) to determine the right function to execute and handle the response.

You can toggle between AI modes via the UI:

• Chat-Only Mode
• AI + Tools Mode
• Agent Mode (multi-step planning, coming soon)

---

🚀 Get Started

1. Choose your preferred model type (local or online).
2. Start the backend using .NET 9
3. Start the frontend using Angular CLI
4. Interact with AIChatBot at http://localhost:4200/

---

💖 Contributing

Pull requests and suggestions are welcome! Feel free to fork the repo and enhance it.

---

📄 License

This project is open-source and available under the MIT License.