Skip to content

Owen-Peng1206/linebot-agent-project

BranchesTags

Repository files navigation

Linebot agent project (LINE Bot API + FastAPI + OpenAI agent python)

Project Description

This project is an intelligent customer service system built on the LINE platform, integrating FastAPI, OpenAI models, and various tools. It uses Redis to store conversation history, supports natural language processing, weather information queries, image generation, and other multi-functional interactions.

Demo

  • Chat

Chat.

  • Get weather

Get weather.

  • Generate image

Generate image.

Features

  • Real-time conversation handling (supports clearing chat history)
  • Multilingual support (Traditional Chinese / English / Japanese / Korean)
  • Weather information lookup (Integrated with OpenWeatherMap API)
  • ComfyUI image generation service
  • Web search and content crawling features
  • Highly scalable tool architecture

Technologies Used

  • LINE Messaging API - The Line Messaging API establishes bidirectional communication between developer services and LINE users.
  • FastAPI - Handles LINE Bot Webhook
  • OpenAI Agents python framework - Intelligent conversation engine
  • Redis - Conversation history storage and management
  • ComfyUI - Image generation service
  • Aiohttp - Asynchronous HTTP client
  • Minio - Image data storage
  • Docker - Containerized deployment solution
  • Google Maps search MCP server - Serarch google maps data by MCP server

Setup

  1. Clone the repository to your local machine.

    git clone https://github.com/Owen-Peng1206/linebot-agent-project.git

  2. Setting your environment variables:

    LINE_CHANNEL_SECRET="YOUR_LINE_CHANNEL_SECRET"
LINE_CHANNEL_ACCESS_TOKEN="YOUR_LINE_CHANNEL_ACCESS_TOKEN"
LINE_CHAT_HISTORY_LENGTH="YOUR_LINE_CHAT_HISTORY_LENGTH" # e.g. 100
WEATHERMAP_API_KEY="YOUR_OPENWEATHERMAP_API_KEY"
COMFYUI_WS_ENDPOINT="http://YOUR.COMFYUI.ADDRESS:PORT"
COMFYUI_WORKFLOW_PATH="YOUR_COMFYUI_WORKFLOW_PATH" # e.g. data/COMFYUI_WORKFLOW.json
OPENAI_COMPATIBLE_API_BASE_URL="YOUR_LLM_BASE_URL" # e.g. https://XXXLLM.YOUR_URL/openai/  
OPENAI_COMPATIBLE_API_KEY="YOUR_LLM_API_KEY" # e.g. sk-366df9446d3247e4b1107898ab25d5b5
OPENAI_COMPATIBLE_API_MODEL_NAME="YOUR_LLM_MODEL_NAME" # e.g. qwen3-30b-a3b
REDIS_HOST_ADDRESS="YOUR.REDIS.HOST.ADDRESS" # e.g.192.168.50.100
REDIS_HOST_PORT="YOUR.REDIS.HOST.PORT" # e.g. 6379
GOOGLE_SEARCH_API_KEY="YOUR_GOOGLE_SEARCH_API_KEY" #your_google_api_key
GOOGLE_CX="YOUR_GOOGLESEARCH_ENGINE_ID" #your_custom_search_engine_id
SEARCH_ENGINE="YOUR_SEARCH_ENGINE"  # or "duckduckgo" "google"
GOOGLE_MAPS_API_KEY="YOUR_GOOGLE_MAPS_API_KEY" #your_google_maps_api_key
MINIO_ACCESS_KEY="YOUR_MINIO_ACCESS_KEY" # e.g. 23TUJDWEJLKFRFGSBVSFGS
MINIO_SECRET_KEY="YOUR_MINIO_SECRET_KEY" # e.g. cbci00kwhYiuIpIX0kWLKLJDHUGDFBKSdobT
MINIO_URL_API="YOUR_MINIO_URL_API" # e.g. https://XXXAWS.YOUR_URL:443
MINIO_URL_WEBUI="YOUR_MINIO_URL_WEBUI" # e.g. https://XXXAWS.YOUR_URL
MINIO_BUCKET="YOUR_MINIO_BUCKET" # e.g. image

  3. Install necessory packages:

    pip install -r requirements.txt

  4. Start FastAPI service:

    uvicorn main:app --reload --host=0.0.0.0 --port=8001

  5. Configure LINE Bot Webhook URL point to your Line Bot webhook address

Usage

Text Processing

  • Supports natural conversation and multilingual switching
  • Automatically records conversation history (retains 41 entries)

Useful tool

Tool Name Function Description
get_weather Query city weather information
generate_image Generate images through ComfyUI
web_search Web search (e.g., Google/DuckDuckGo)
web_scrape Web content scraper
Google Maps Seache Maps data form google maps

Deployment Options

Local development

Only support docker or linux.

  uvicorn main:app --reload --host=0.0.0.0 --port=8001

Docker depoly

Dockfile example:

# Stage 1: Build (using a full development environment)
FROM nikolaik/python-nodejs:python3.13-nodejs24-alpine AS builder
RUN pip install --user some-package

COPY *.py /app/
COPY *.json /data/
WORKDIR /app

# Install necessary packages
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

EXPOSE 8001

# Run with uvicorn
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8001"]

compose.yaml example:

    services:
    linebot-agent-project:
        image: linebot-agent-project:latest
        container_name: linebot-agent-project
        ports:
        - 8001:8001
        volumes:
        - ./data:/data      
        environment:
            LINE_CHANNEL_SECRET : ${LINE_CHANNEL_SECRET}
            LINE_CHANNEL_ACCESS_TOKEN : ${LINE_CHANNEL_ACCESS_TOKEN}
            LINE_CHAT_HISTORY_LENGTH : ${LINE_CHAT_HISTORY_LENGTH}
            WEATHERMAP_API_KEY : ${WEATHERMAP_API_KEY}
            COMFYUI_WS_ENDPOINT : ${COMFYUI_WS_ENDPOINT}
            COMFYUI_WORKFLOW_PATH : ${COMFYUI_WORKFLOW_PATH}            
            OPENAI_COMPATIBLE_API_BASE_URL : ${OPENAI_COMPATIBLE_API_BASE_URL}
            OPENAI_COMPATIBLE_API_KEY : ${OPENAI_COMPATIBLE_API_KEY}
            OPENAI_COMPATIBLE_API_MODEL_NAME : ${OPENAI_COMPATIBLE_API_MODEL_NAME}
            REDIS_HOST_ADDRESS : ${REDIS_HOST_ADDRESS}
            REDIS_HOST_PORT : ${REDIS_HOST_PORT}
            GOOGLE_SEARCH_API_KEY : ${GOOGLE_SEARCH_API_KEY} #your_google_api_key
            GOOGLE_CX : ${GOOGLE_CX} #your_custom_search_engine_id
            SEARCH_ENGINE : ${SEARCH_ENGINE}  # or "duckduckgo" "google"
            GOOGLE_MAPS_API_KEY : ${GOOGLE_MAPS_API_KEY}   
            MINIO_ACCESS_KEY : ${MINIO_ACCESS_KEY}
            MINIO_SECRET_KEY : ${MINIO_SECRET_KEY}
            MINIO_URL_API : ${MINIO_URL_API}
            MINIO_URL_WEBUI : ${MINIO_URL_WEBUI}
            MINIO_BUCKET  : ${MINIO_BUCKET}                
        restart: on-failure:5	      
        network_mode: host

docker-compose.yaml example:

    services:
    linebot-agent-project:
        image: linebot-agent-project:latest
        container_name: linebot-agent-project
        build:
        context: .    
        ports:
        - 8001:8001
        volumes:
        - ./data:/data          
        environment:
            LINE_CHANNEL_SECRET : ${LINE_CHANNEL_SECRET}
            LINE_CHANNEL_ACCESS_TOKEN : ${LINE_CHANNEL_ACCESS_TOKEN}
            LINE_CHAT_HISTORY_LENGTH : ${LINE_CHAT_HISTORY_LENGTH}
            WEATHERMAP_API_KEY : ${WEATHERMAP_API_KEY}
            COMFYUI_WS_ENDPOINT : ${COMFYUI_WS_ENDPOINT}
            COMFYUI_WORKFLOW_PATH : ${COMFYUI_WORKFLOW_PATH}            
            OPENAI_COMPATIBLE_API_BASE_URL : ${OPENAI_COMPATIBLE_API_BASE_URL}
            OPENAI_COMPATIBLE_API_KEY : ${OPENAI_COMPATIBLE_API_KEY}
            OPENAI_COMPATIBLE_API_MODEL_NAME : ${OPENAI_COMPATIBLE_API_MODEL_NAME}
            REDIS_HOST_ADDRESS : ${REDIS_HOST_ADDRESS}
            REDIS_HOST_PORT : ${REDIS_HOST_PORT}
            GOOGLE_SEARCH_API_KEY : ${GOOGLE_SEARCH_API_KEY} #your_google_api_key
            GOOGLE_CX : ${GOOGLE_CX} #your_custom_search_engine_id
            SEARCH_ENGINE : ${SEARCH_ENGINE}  # or "duckduckgo" "google"
            GOOGLE_MAPS_API_KEY : ${GOOGLE_MAPS_API_KEY}   
            MINIO_ACCESS_KEY : ${MINIO_ACCESS_KEY}
            MINIO_SECRET_KEY : ${MINIO_SECRET_KEY}
            MINIO_URL_API : ${MINIO_URL_API}
            MINIO_URL_WEBUI : ${MINIO_URL_WEBUI}
            MINIO_BUCKET  : ${MINIO_BUCKET}                    
        restart: on-failure:5

redis compose.yaml example:

    version: '3.3'
    services:
    redis:
        image: redis:latest
        container_name: redis_contaier
        restart: on-failure:5	   
        ports:
        - '6379:6379'
        volumes:
        - ./data:/data
        - ./redis.conf:/usr/local/etc/redis/redis.conf
        - ./logs:/logs
        command: redis-server /usr/local/etc/redis/redis.conf

minio compose.yaml example:

version: '3'

services:
  minio:
    image: minio/minio:latest
    ports:
      - 9000:9000
      - 9001:9001
    networks:
      - minionetwork
    volumes:
      - './data:/data'
      - './config:/root/.minio'
    environment:
      - MINIO_ROOT_USER=admin
      - MINIO_ROOT_PASSWORD=YOUR_PASSWORD
    command: server /data --address=":9000" --console-address=":9001"
networks:
  minionetwork:
    driver: bridge

  1. Build image:

    docker build -t linebot-agent-project:latest .

  2. Run container:

    docker compose run --remove-orphans linebot-agent-project

  3. tag your image

    docker tag linebot-agent-project:latest hub.YOUR_REGISTRY/linebot-agent-project:latest

  4. Push your image

    docker push hub.YOUR_REGISTRY/linebot-agent-project:latest

Note

Before using the generate image function, you need to make sure that ComfyUI and minio have been built, and that you can generate images for text in ComfyUI through the correct WORKFLOW.json

About

This project is an intelligent customer service system built on the LINE platform, integrating FastAPI, OpenAI models, and various tools. It uses Redis to store conversation history, supports natural language processing, weather information queries, image generation, and other multi-functional interactions.

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages