File size: 3,052 Bytes
33d0ae4 47d523d bd34882 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 |
---
title: Construction Company AI Assistant
emoji: 🏗️
colorFrom: gray
colorTo: yellow
sdk: gradio
sdk_version: "5.29.1"
app_file: app.py
pinned: false
---
# Construction Company AI Assistant
An expert, construction-only AI assistant with a modern Gradio UI, powered by DeepSeek R1 via OpenRouter, optional live web search (Serper), and CrewAI agents.
## Features
- **Construction-only assistant**: Politely declines non-construction queries
- **DeepSeek R1 reasoning model**: Via OpenRouter
- **Optional live web search**: Uses Serper to fetch current prices, codes, and updates
- **Memory**: Remembers the last 5 Q&A pairs
- **CrewAI agents**: Expert assistant + optional research agent
- **Modern UI**: Construction-themed styling, examples, and status indicators
## What’s inside (tech)
- **Model**: DeepSeek R1 (OpenRouter)
- **Agent framework**: CrewAI (`Agent`, `Task`, `Crew`, `LLM`)
- **Web search tool**: `SerperDevTool` (optional)
- **UI**: Gradio (messages format), auto-launches browser
## Installation
1) Create/activate a Python 3.10+ environment.
2) Install dependencies:
```bash
pip install gradio crewai crewai-tools langchain-openai
```
## Configuration
The app is preconfigured in `app.py` to use:
- OpenRouter (DeepSeek R1) for responses
- Optional Serper for web search (set `SERPER_API_KEY` to enable)
Set Serper (optional) if you want live web search:
- Windows (PowerShell):
```powershell
$env:SERPER_API_KEY="your-serper-api-key"
```
- Linux/Mac:
```bash
export SERPER_API_KEY="your-serper-api-key"
```
If you prefer, you can also run the optional setup helper:
```bash
python setup_env.py
```
## Run
```bash
python app.py
```
By default the app launches on:
- Local: `http://localhost:7863`
- A public Gradio share link (shown in the console)
The UI auto-opens in your browser (`inbrowser=True`).
## How it works (high-level)
- Incoming questions are first filtered to ensure they are construction-related.
- For time-sensitive questions (e.g., “current”, “latest”, “2024/2025”, “price”, “cost”, “regulation”), a research agent may search the web (if Serper is enabled) and pass findings to the expert agent.
- If anything fails, a direct LLM fallback path still answers construction questions.
## Example questions
- “Latest fire safety codes for high-rise buildings (2024)?”
- “Current price of M30 ready-mix concrete per m³ in my area?”
- “OSHA requirements for scaffolding on construction sites?”
- “How to size rebar for a medium-span concrete beam?”
- “Best project management approach for a multi-tower site?”
## Troubleshooting
- **Port already in use**: Change `server_port` in `app.py` (default is 7863).
- **Web search disabled**: Set `SERPER_API_KEY` and restart.
- **Import errors**: Run the install command again and ensure your environment is active.
## Notes
- The assistant strictly answers construction-related topics (building, safety, materials, project management, engineering). Non-construction queries are declined by design.
|