Skip to content

Commit 5ce6c63

Browse files
committed
docs(mission-control): add install section before chapter 1
Mirror of the framework-repo edit. The Mission Control walkthrough jumped straight into Chapter 1's service code without telling readers how to install anything first. QA agents working through the guide had to figure it out themselves. Added a tabbed Install section between the architecture diagram and Chapter 1, covering Python (uv pip / pip + aster-rpc + aster-cli) and TypeScript (bun/npm add @aster-rpc/aster + uv tool install aster-cli). The TypeScript path is honest about needing Python for the shared CLI tools -- "one-time install, day-to-day work stays in TypeScript" -- so TS readers don't feel ambushed.
1 parent d7a851f commit 5ce6c63

File tree

1 file changed

+47
-0
lines changed

1 file changed

+47
-0
lines changed

docs/quickstart/mission-control.mdx

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,53 @@ graph LR
101101
102102
---
103103

104+
## Install
105+
106+
<LanguageTabs defaultValue="python">
107+
<TabItem value="python" label="Python">
108+
109+
Two packages -- the framework and the CLI:
110+
111+
```bash
112+
uv pip install aster-rpc aster-cli
113+
# or:
114+
pip install aster-rpc aster-cli
115+
```
116+
117+
The framework gives you `from aster import ...` for your service code. The CLI gives you `aster shell`, `aster trust keygen`, `aster enroll node`, and `aster contract gen-client` -- the operator tools you'll use throughout this guide.
118+
119+
**Requirements:** Python 3.9 -- 3.13, macOS / Linux / Windows.
120+
121+
</TabItem>
122+
<TabItem value="typescript" label="TypeScript">
123+
124+
Two pieces -- the TypeScript runtime and the CLI tools:
125+
126+
```bash
127+
# In your TypeScript project:
128+
bun add @aster-rpc/aster
129+
# or: npm install @aster-rpc/aster
130+
131+
# The CLI ships as a Python package and is shared across all language
132+
# bindings -- one shell, one trust manager, one contract generator,
133+
# usable against any Aster server regardless of language:
134+
uv tool install aster-cli
135+
# or: pip install aster-cli
136+
```
137+
138+
**Requirements:** Node.js 20+ or Bun 1.0+ for the TypeScript runtime. Python 3.9 -- 3.13 for the CLI (one-time install; day-to-day work stays in TypeScript).
139+
140+
</TabItem>
141+
</LanguageTabs>
142+
143+
Verify:
144+
145+
```bash
146+
aster --version
147+
```
148+
149+
---
150+
104151
## Chapter 1: Your First Agent Check-In (5 min)
105152

106153
**Goal:** The full working version of what you just saw — define a service,

0 commit comments

Comments
 (0)