Skip to content

Commit cf73174

Browse files
committed
Add e203_ifu_litebpu example to workshop demo
1 parent 1e5053e commit cf73174

414 files changed

Lines changed: 25884 additions & 195 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/envbase.yaml

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -91,10 +91,6 @@ jobs:
9191

9292
build-and-push-workshop:
9393
runs-on: ubuntu-latest
94-
# Optional: depends on full image if we use it as base,
95-
# but here we use ucagent:latest which is built from main repo.
96-
# To be safe, we can run it after build-and-push-full if we want to ensure base layers are available
97-
needs: build-and-push-full
9894
permissions:
9995
contents: read
10096
packages: write
@@ -118,7 +114,7 @@ jobs:
118114
with:
119115
context: .
120116
file: ./docker/Dockerfile.workshop
121-
platforms: linux/amd64,linux/arm64
117+
platforms: linux/amd64
122118
push: true
123119
tags: |
124120
${{ env.REGISTRY }}/xs-mlvp/workshop:latest

docker/Dockerfile.workshop

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# UCAgent Workshop Docker Image
2-
ARG BASE_IMAGE=localhost/lucagent:latest
3-
FROM ${BASE_IMAGE}
2+
ARG BASE_IMAGE=ghcr.io/xs-mlvp/ucagent:latest
3+
FROM --platform=linux/amd64 ${BASE_IMAGE}
44

55
# Set environment variables
66
ENV SUMMIT_DATA_DIR=/workspace/UCAgent/summit_examples
@@ -10,7 +10,7 @@ ENV SUMMIT_DATA_DIR=/workspace/UCAgent/summit_examples
1010
COPY workshop/data/ ${SUMMIT_DATA_DIR}/
1111

1212
# Copy and setup startup script
13-
COPY docker/start_demo.sh /workspace/UCAgent/start_demo.sh
13+
COPY workshop/start_demo.sh /workspace/UCAgent/start_demo.sh
1414
RUN chmod +x /workspace/UCAgent/start_demo.sh
1515

1616
# Expose ports for Web UI and Agents

workshop/ADD_NEW_EXAMPLE.md

Lines changed: 0 additions & 88 deletions
This file was deleted.
Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@ This guide will walk you through pulling the pre-built environment, launching th
77
## 📦 Repository Overview
88

99
In this repository, you will find:
10-
- **Pre-prepared Cases**: Classic verification examples along with their historical offline verification records.
10+
11+
- **Pre-prepared Cases**: Classic verification examples along with their historical verification records.
1112
- **Docker Scripts**: The `Dockerfile` and `start_demo.sh` scripts, which our CI uses to automatically build and publish the workshop image.
1213
- **Environment Template**: A `.env.template` file for optional API configuration.
1314

@@ -18,23 +19,30 @@ In this repository, you will find:
1819
You **do not** need to build the Docker image yourself. The tutorial repository's CI has automatically built and published the image for you.
1920

2021
### 1. Pull the Docker Image
22+
2123
First, pull the latest workshop image to your local machine:
24+
2225
```bash
23-
docker pull ghcr.io/xs-mlvp/ucagent:workshop_demo
26+
docker pull ghcr.io/xs-mlvp/workshop:latest
2427
```
2528

2629
### 2. Launch the Demo Environment
30+
2731
Start the container using the following command. This will spin up the Master API server and load the pre-configured background agents:
32+
2833
```bash
2934
docker run -it --rm --network host ghcr.io/xs-mlvp/ucagent:workshop_demo
3035
```
31-
*(Note: We use `--network host` so the container can easily map to your local ports and share your host's network settings.)*
36+
37+
_(Note: We use `--network host` so the container can easily map to your local ports and share your host's network settings.)_
3238

3339
### 3. Explore the Web UI
40+
3441
Once the terminal indicates that all services have started, open your web browser and navigate to:
3542
👉 **http://localhost:8800**
3643

3744
In this unified Master Web Interface, you can:
45+
3846
- **View Pre-loaded Tasks**: On the left-hand task panel, you will see the cases. Both should have a green **Online** status indicator.
3947
- **Review History**: Click the **API** connection button next to any task to jump into its real-time control center. Here, you can review previously generated code, stage verification logs, and Diff files without needing any LLM API keys.
4048

@@ -46,6 +54,7 @@ The quick start above is perfect for exploring the UI and viewing the pre-genera
4654

4755
1. **Prepare your `.env` file**
4856
Copy the provided template and fill in your API credentials (e.g., OpenAI or a compatible interface):
57+
4958
```bash
5059
cp .env.template .env
5160
# Edit .env to add your OPENAI_API_KEY, OPENAI_API_BASE, and OPENAI_MODEL
@@ -54,7 +63,7 @@ The quick start above is perfect for exploring the UI and viewing the pre-genera
5463
2. **Launch with API Access**
5564
Run the container again, this time attaching your `.env` file so the agents can connect to the LLM:
5665
```bash
57-
docker run -it --rm --network host --env-file .env ghcr.io/xs-mlvp/ucagent:workshop_demo
66+
docker run -it --rm --network host --env-file .env ghcr.io/xs-mlvp/workshop:latest
5867
```
59-
68+
6069
With your API keys successfully loaded, the Agents are now fully empowered to execute new automated verification workflows based on your commands!
Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@
77
## 📦 仓库内容简介
88

99
在这个仓库中,包含了以下内容:
10-
- **预置验证案例**:经典的数字电路验证案例(如 Adder 加法器和 ALU754 浮点运算器),以及它们离线跑完的历史验证记录。
10+
11+
- **预置验证案例**:经典的数字电路验证案例(如exu_alu和 ifu_bpu),以及它们离线跑完的历史验证记录。
1112
- **Docker 脚本**`Dockerfile``start_demo.sh`,我们的 CI 流水线会自动使用它们来构建和发布本次 Workshop 的镜像。
1213
- **环境配置模板**`.env.template` 文件,用于你在后续环节配置自己的大模型 API。
1314

@@ -18,23 +19,30 @@
1819
**不需要**从头开始构建 Docker 镜像,tutorial 仓库的 CI 已经自动帮你打包并发布好了。
1920

2021
### 1. 拉取镜像
22+
2123
首先,将最新的 Workshop 镜像拉取到你的本地电脑:
24+
2225
```bash
23-
docker pull ghcr.io/xs-mlvp/ucagent:workshop_demo
26+
docker pull ghcr.io/xs-mlvp/workshop:latest
2427
```
2528

2629
### 2. 启动演示环境
30+
2731
运行以下命令来启动容器。这会自动启动 Master API 服务,并在后台加载好我们为你准备的预置任务:
32+
2833
```bash
29-
docker run -it --rm --network host ghcr.io/xs-mlvp/ucagent:workshop_demo
34+
docker run -it --rm --network host ghcr.io/xs-mlvp/workshop:latest
3035
```
31-
*(注意:我们使用了 `--network host` 参数,这样容器可以直接映射并使用你宿主机的网络和端口。)*
36+
37+
_(注意:我们使用了 `--network host` 参数,这样容器可以直接映射并使用你宿主机的网络和端口。)_
3238

3339
### 3. 探索 Web UI
40+
3441
当终端提示服务启动完毕后,打开你的浏览器并访问:
3542
👉 **http://localhost:8800**
3643

3744
在这个统一管理的 Master Web 界面中,你可以:
45+
3846
- **查看预置任务**:在左侧的任务面板中,你会看到 `Adder``ALU754` 两个案例,它们应该都已经亮起了绿色的 **Online** 状态灯。
3947
- **复盘历史记录**:点击任意任务旁边的 **API** 按钮,即可进入该任务的实时控制台。在这里,你不需要配置任何大模型 Key,就可以直接查看 AI 之前生成的验证代码、日志以及阶段比对(Diff)。
4048

@@ -46,6 +54,7 @@ docker run -it --rm --network host ghcr.io/xs-mlvp/ucagent:workshop_demo
4654

4755
1. **准备 `.env` 配置文件**
4856
复制我们提供的模板文件,填入你的 API Key 等信息(支持 OpenAI 或兼容接口):
57+
4958
```bash
5059
cp .env.template .env
5160
# 编辑 .env 文件,补全 OPENAI_API_KEY, OPENAI_API_BASE 和 OPENAI_MODEL
@@ -56,5 +65,5 @@ docker run -it --rm --network host ghcr.io/xs-mlvp/ucagent:workshop_demo
5665
```bash
5766
docker run -it --rm --network host --env-file .env ghcr.io/xs-mlvp/ucagent:workshop_demo
5867
```
59-
68+
6069
配置成功后,各个 Agent 就拥有了完整的执行能力,你可以开始下达新的指令,开启真正的自动化验证之旅了!

0 commit comments

Comments
 (0)