# agentic-ai-CAIO

**Repository Path**: alphafuture/agentic-ai-caio

## Basic Information

- **Project Name**: agentic-ai-CAIO
- **Description**: 更适合更多传统企业的技术仔，致敬Andrew Ng的开源项目 https://github.com/https-deeplearning-ai/agentic-ai-public
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-11
- **Last Updated**: 2025-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Reflective Research Agent (FastAPI + Postgres, single container)
## 小窗智能基于原项目修改，为您企业的AI工程师定制
### 核心修改1: 支持国内大模型，zhipu deepseek kimi（经测试，和chatgpt api效果类似）
### 核心修改2: 去掉docker的运行方式，更适合快速测试及模块复用
### 核心修改3: 去掉数据库，精简运行

A FastAPI web app that plans a research workflow, runs tool-using agents (Tavily, arXiv, Wikipedia), and stores task state/results in Postgres.
This repo includes a Docker setup that runs **Postgres + the API in one container** (for local/dev).

## Features

* `/` serves a simple UI (Jinja2 template) to kick off a research task.
* `/generate_report` kicks off a threaded, multi-step agent workflow (planner → research/writer/editor).
* `/task_progress/{task_id}` live status for each step/substep.
* `/task_status/{task_id}` final status + report.

---

## Project layout (key paths)

```
.
├─ main.py                      # FastAPI app (your file shown above)
├─ src/
│  ├─ planning_agent.py         # planner_agent(), executor_agent_step()
│  ├─ agents.py                 # research_agent, writer_agent, editor_agent  (example)
│  └─ research_tools.py         # tavily_search_tool, arxiv_search_tool, wikipedia_search_tool
├─ templates/
│  └─ index.html                # UI page rendered by "/"
├─ static/                      # optional static assets (css/js)
├─ docker/
│  └─ entrypoint.sh             # starts Postgres, prepares DB, then launches Uvicorn
├─ requirements.txt
├─ Dockerfile
└─ README.md
```

> Make sure `templates/index.html` and (optionally) `static/` exist and are copied into the image.

---

## Prerequisites

* **No Docker**


* API keys setting:

  ```
  !!!非常重要，以至于用中文提示大家
  src/util.py 修改对应的key，在主文件夹手动新增.env文件处理或直接修改

  src/research_tools.py/tavily_search_tool 函数里的key在tavily官网中创建

  Then, run python main.py
  ```

* Full Docker deps live in requirements.txt; local development uses a leaner subset:

  * `fastapi`, `uvicorn`, `sqlalchemy`, `python-dotenv`, `jinja2`, `requests`, `wikipedia`, etc.
  * Plus any libs used by your `aisuite` client.

---

### Open the app

* UI: [http://localhost:12001/](http://localhost:12001/)
* Docs: [http://localhost:12001/docs](http://localhost:12001/docs)