# AIForm

**Repository Path**: codezzzsleep/aiform

## Basic Information

- **Project Name**: AIForm
- **Description**: AI 驱动的问卷调查
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-05
- **Last Updated**: 2026-02-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AIForm

#### Description
AI-driven survey simulator: humans design surveys, AI personas answer them, and you export results (JSON/CSV).

#### Software Architecture
- `aiform/`: core library (schemas, simulation, import/export)
- CLI: `aiform simulate ...`
- Optional UI: `streamlit run streamlit_app.py`

#### Installation

```powershell
cd e:\hu\aiform
pip install -e .
```

Optional UI:
```powershell
pip install -e ".[ui]"
```

#### Instructions

1) Write example files into `examples/`
```powershell
aiform init
```

2) Configure model (choose one)

- Option A: environment variables
```powershell
$env:OPENAI_API_KEY="YOUR_KEY"
$env:AIFORM_MODEL="gpt-4o-mini"
```

- Option B: `.env` file at repo root
```text
OPENAI_API_KEY=YOUR_KEY
AIFORM_MODEL=gpt-4o-mini
```

3) Run simulation (writes to `outputs/`)
```powershell
aiform simulate --survey examples/survey.json --personas examples/personas.json --out outputs/result.json --csv outputs/result.csv
```

4) Offline demo (no model calls):
```powershell
$env:AIFORM_PROVIDER="mock"
aiform simulate --survey examples/survey.json --personas examples/personas.json
```

5) Optional UI
```powershell
streamlit run streamlit_app.py
```

#### Contribution

1.  Fork the repository
2.  Create Feat_xxx branch
3.  Commit your code
4.  Create Pull Request


#### Gitee Feature

1.  You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md
2.  Gitee blog [blog.gitee.com](https://blog.gitee.com)
3.  Explore open source project [https://gitee.com/explore](https://gitee.com/explore)
4.  The most valuable open source project [GVP](https://gitee.com/gvp)
5.  The manual of Gitee [https://gitee.com/help](https://gitee.com/help)
6.  The most popular members  [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)