deep question
- Repo stars 24,518
- Author repo DeepTutor
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @HKUDS · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Deep Question (Quiz Generation)
Use the `exec` tool to invoke DeepTutor's quiz generation pipeline (ideation → evaluation → generation → validation).
## When to Use
- User wants **practice questions** or **quizzes** on a topic
- User is preparing for an exam or self-testing
- User asks to "generate questions", "quiz me", "create practice problems"
## Command
```bash
deeptutor run deep_question "<topic>" --format json -l <lang> [options]
```
### Options
| Flag | Description |
|------|-------------|
| `-l <lang>` | Response language: `en` or `zh` |
| `--config num_questions=N` | Number of questions (default: 1, max: 50) |
| `--config difficulty=<level>` | `easy`, `medium`, `hard` |
| `--config question_type=<type>` | `multiple_choice`, `open_ended`, `true_false`, etc. |
| `--config mode=<mode>` | `custom` (default) or `mimic` |
| `-t rag` | Ground questions in a knowledge base |
| `--kb <name>` | Knowledge base to use |
## Examples
Basic quiz:
```bash
deeptutor run deep_question "Calculus integration techniques" --format json -l en --config num_questions=5 --config difficulty=medium
```
Multiple-choice from a textbook:
```bash
deeptutor run deep_question "Chapter 3: Linear Algebra" --format json -l zh -t rag --kb math-textbook --config question_type=multiple_choice --config num_questions=10
```
Hard open-ended questions:
```bash
deeptutor run deep_question "Quantum mechanics fundamentals" --format json -l en --config difficulty=hard --config question_type=open_ended
```
## Important
- This capability can take **over a minute** for multiple questions — use `timeout=300` with the `exec` tool.
- Parse NDJSON events with `"type": "content"` for the generated questions and answers.
Sections and files
Listed in source order.
sections -> When to Use → Command → Options → Examples → Important
terms -> practice questions · quizzes · over a minute · Use the exec tool to invoke DeepTutor's quiz generation pipeline (ideation → evaluation → generation → validation). · - This capability can take over a minute for multiple questions — use timeout=300 with the exec tool.
files/cmd -> exec · -l <lang> · --config num_questions=N · --config difficulty=<level> · easy · medium · hard · --config question_type=<type>
body sha256 -> 0697b7697b30
When to Use
User wants practice questions or quizzes on a topic User is preparing for an exam or self-testing User asks to "generate questions", "quiz me", "create practice problems"
Options
Flag · Description
-l <lang>· Response language:enorzh--config num_questions=N· Number of questions (default: 1, max: 50)--config difficulty=<level>·easy,medium,hard--config question_type=<type>·multiple_choice,open_ended,true_false, etc.Examples
Basic quiz: Multiple-choice from a textbook: Hard open-ended questions:
Important
This capability can take over a minute for multiple questions — use
timeout=300with theexectool. Parse NDJSON events with"type": "content"for the generated questions and answers.