Skip to content

Commit 4a82911

Browse files
committed
upd install proc
1 parent 884ccf6 commit 4a82911

File tree

3 files changed

+17
-37
lines changed

3 files changed

+17
-37
lines changed

docs/Architecture-Internals.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,12 @@ The subsections below described the steps to:
1515
To create the projects:
1616

1717
1. Install the user version of the API Logic Server
18-
2. Be sure to start the Manager: `als start`
18+
2. Start the Manager: `als start`
1919
3. Be sure you have installed the VSCode CLI - see [the VSCode CLI procedure](IDE-Customize.md/#vscode-cli){:target="_blank" rel="noopener"}
20-
4. Run [the install-ApiLogicServer-dev procedure](https://github.com/ApiLogicServer/ApiLogicServer-src/blob/main/install-ApiLogicServer-dev.sh)
20+
4. In your CLI terminal window:
2121
* Note: Windows users use `install-ApiLogicServer-dev.ps1`)
2222

2323
```bash title="Install API Logic Server Development environment"
24-
cd ~/dev/ApiLogicServer/ # project directories created here
2524
sh system/install-ApiLogicServer-dev/install-ApiLogicServer-dev.sh
2625
```
2726

docs/Sample-Basic-Tour.md

Lines changed: 15 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ version info: 2.0 (05/24/2025)
33
---
44
## Welcome to GenAI-Logic
55

6-
1. ***Instant microservices*** (APIs and Admin Apps) from a database or **GenAI prompt** -- 1 command and you are ready for MCP, Vibe and Business User Collaboration.
6+
1. ***Instant mcp-enabled microservices*** (APIs and Admin Apps) from a database or **GenAI prompt** -- one command and you are ready for MCP, Vibe and Business User Collaboration.
77

88
2. ***Customize*** with **Rules** and Python in your IDE: created projects use standard Python libraries (Flask, SQLAlchemy)
99

@@ -18,17 +18,9 @@ You are in the [API Logic Server Manager](https://apilogicserver.github.io/Docs/
1818

1919
<details markdown>
2020

21-
<summary> 1. Product Tour - start here</summary>
21+
<summary> 1. Product Tour - Start here</summary>
2222

23-
<br>For a self-demo, use the CLI (**Terminal > New Terminal**), and try the pre-installed [**Basic Demo**](https://apilogicserver.github.io/Docs/Sample-Basic-Demo/):
24-
25-
---
26-
title: Instant Microservices - with Logic and Security
27-
notes: gold is proto (-- doc); alert for apostrophe; links must be absolute (images relative)
28-
version: 0.22 from docsite 5/24/2025
29-
---
30-
31-
See how to build a complete database system -- in minutes instead of weeks or months:
23+
<br>Use the CLI (**Terminal > New Terminal**), and:
3224

3325
1. **An API**, and, we'll add ui and logic to make it a microservice...
3426
2. **Logic and Security:** multi-table constraints and derivations, role-based security, and application integration
@@ -58,7 +50,7 @@ API Logic Server can create projects from existing databases, or use GenAI to cr
5850
&nbsp;
5951
### From Existing Database
6052

61-
This project was created with a command like:
53+
Create the project - use the CLI (**Terminal > New Terminal**), :
6254

6355
```bash
6456
$ ApiLogicServer create --project_name=basic_demo --db_url=basic_demo
@@ -72,7 +64,11 @@ This creates a project by reading your schema. The database is Customer, Orders
7264

7365
### GenAI: New Database
7466

75-
You can create a project from a prompt using GenAI, either by [WebGenAI](WebGenAI.md), or the the [GenAI CLI](WebGenAI-CLI.md){:target="_blank" rel="noopener"} as shown here.
67+
You can create a project from a prompt using GenAI, either by
68+
69+
* [WebGenAI - in the Browser](WebGenAI.md){:target="_blank" rel="noopener"}, or
70+
* [GenAI - docker](WebGenAI-install.md){:target="_blank" rel="noopener"}, or
71+
* [GenAI CLI](WebGenAI-CLI.md){:target="_blank" rel="noopener"} as shown here.
7672

7773
Use the GenAI CLI with or without signup:
7874

@@ -82,8 +78,6 @@ Use the GenAI CLI with or without signup:
8278
als genai --using=system/genai/examples/genai_demo/genai_demo.prompt --project-name=genai_demo
8379
```
8480

85-
86-
8781
2. ***Or,*** you can simulate the process (no signup) using:
8882

8983
```bash
@@ -93,6 +87,7 @@ als genai --repaired-response=system/genai/examples/genai_demo/genai_demo.respon
9387
```
9488

9589
&nbsp;
90+
9691
## 2. Working Software Now
9792

9893
### Open in your IDE and Run
@@ -137,18 +132,19 @@ You can click Customer 2, and see their Orders, and Items.
137132

138133
In little more than a minute, you've used either
139134

140-
* GenAI to create a database and project using Natural Language, or
135+
* **GenAI** to create a database and project using Natural Language, or
141136
* 1 CLI command to create a project from an existing database
142137

143138
The project is standard Python, which you can customize in a standard IDE.
144139

145140
This means you are ready for:
146141

147-
* **Vibe:** instead of creating data mockups, use GenAI to create real data.
148-
And, you'll have projects that are architecurally correct, with shared logic enforced in the server,
149-
available for both User Interfaces and services.
142+
* **Vibe:**
150143

144+
* Instead of creating data mockups, use GenAI to create real data.
151145
* Use you favorite Vibe tools with your running API
146+
* And, you'll have projects that are architecurally correct: shared logic enforced in the server,
147+
available for both User Interfaces and services.
152148

153149
* **MCP:** your project is MCP-ready: `python integration/mcp/mcp_client_executor.py`.
154150
We'll explore more interesting examples below.
@@ -1037,21 +1033,6 @@ ApiLogicServer create --project-name=samples/nw_sample_nocust --db-url=nw
10371033

10381034
&nbsp;
10391035

1040-
## Explore WebGenAI
1041-
1042-
In addition to the CLI examples above, you can use [WebGenAI](https://apilogicserver.github.io/Docs/WebGenAI/) - a web interface for creating projects from prompts. You can install WebGenAI on a server, so that created projects are easy to review with colleagues.
1043-
1044-
To try WebGenAI:
1045-
1046-
```bash
1047-
cd webgenai
1048-
docker compose up
1049-
```
1050-
1051-
You will be directed to the registration process. You will also require a ChatGPT API Key as described above.
1052-
1053-
&nbsp;
1054-
10551036
## Appendix: Demo Summary
10561037

10571038
This is a "cheat sheet" for experienced ALS users, e.g., to show your colleagues.

docs/images.md

Whitespace-only changes.

0 commit comments

Comments
 (0)