https://github.com/hardikpatelse/aichatbot
A full-stack AI chatbot using local (Ollama) & cloud (OpenRouter) LLMs. Built with .NET 9 API & Angular 20 UI. Easily run models like PHI-3, Mistral, Gemma, Llama3 locally or online.
https://github.com/hardikpatelse/aichatbot
ai-chatbot angular chatbot dot-net dot-net-9 dotnet full-stack llm local-ai ollama ollama-api openai-alternative openrouter openrouter-api wsl wsl-ubuntu
Last synced: 3 months ago
JSON representation
A full-stack AI chatbot using local (Ollama) & cloud (OpenRouter) LLMs. Built with .NET 9 API & Angular 20 UI. Easily run models like PHI-3, Mistral, Gemma, Llama3 locally or online.
- Host: GitHub
- URL: https://github.com/hardikpatelse/aichatbot
- Owner: hardikpatelse
- License: mit
- Created: 2025-06-23T13:43:45.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-07-06T13:41:21.000Z (3 months ago)
- Last Synced: 2025-07-06T14:35:03.540Z (3 months ago)
- Topics: ai-chatbot, angular, chatbot, dot-net, dot-net-9, dotnet, full-stack, llm, local-ai, ollama, ollama-api, openai-alternative, openrouter, openrouter-api, wsl, wsl-ubuntu
- Language: C#
- Homepage:
- Size: 225 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# 🤖 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](https://ollama.com)) and cloud-based models via [OpenRouter](https://openrouter.ai). 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](https://youtu.be/ReTiWZABiD8)
---
## 🛠️ 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](https://dotnet.microsoft.com/en-us/download)
- [Node.js (v20+)](https://nodejs.org/)
- [Angular CLI](https://angular.io/cli) (`npm install -g @angular/cli`)
- [Ollama](https://ollama.com/download) installed in Ubuntu for running local AI models
- Optional: Account on [https://openrouter.ai](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
```bash
curl -fsSL https://ollama.com/install.sh | sh
```
### 3. Pull and Run Models
To pull and run the desired models:
```bash
# 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
```bash
# 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:
```bash
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](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:
```bash
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:
```bash
dotnet restore
dotnet build
dotnet run
```
- Ensure `appsettings.json` file includes:
```env
ApiKey=YOUR_KEY_HERE
```
### 💬 Frontend (UI - Angular 20)
1. Navigate to `AIChatBot.UI/`
2. Run:
```bash
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](LICENSE).