Updated readmes with latest

Author: EdyVision

README.md

@@ -1,41 +1,68 @@
 # serverless-python-dev
 
-Canonical source for [*Building Serverless Python Apps Using FastAPI and AWS*](https://www.amazon.com/dp/B09Z7CSDRX). Upload and maintain this repository on GitHub as **CloudBytesCollection/serverless-python-dev**.
+<p align="center">
+  <img src="./python_book.jpg" alt="Building Serverless Python Apps on AWS" width="360" />
+</p>
 
-The **Node.js** book uses a separate tree: `serverless-nodejs-dev/` with `sample-aws-starter-project` and `sample-aws-book-api`. Do not mix the two books’ folders.
+Companion code for **Building Serverless Python Apps on AWS** (Cloud Bytes Collection). Clone this repo and open the project that matches the chapter you are on.
 
-## Projects in this repo
+## Which project should I use?
 
-| Path | Use in the book |
-|------|-----------------|
-| [sample-fastapi-graphql-starter-project](./sample-fastapi-graphql-starter-project/) | Chapter 2 — FastAPI + Strawberry starter (`hello_world`, local GraphQL) |
-| [sample-fastapi-graphql-book-api](./sample-fastapi-graphql-book-api/) | Main example — books/reviews API, MongoDB, Docker, CDK/Fargate, CI/CD |
-| [sample-fastapi-graphql-book-api-mcp](./sample-fastapi-graphql-book-api-mcp/) | Book API + Chapter 9 MCP (`fastapi-mcp`, REST routes as tools) |
+| Folder | When to use it |
+|--------|----------------|
+| [sample-fastapi-graphql-starter-project](./sample-fastapi-graphql-starter-project/) | **Chapter 2** — FastAPI + Strawberry starter (`hello_world`, local GraphQL) |
+| [sample-fastapi-graphql-book-api](./sample-fastapi-graphql-book-api/) | **Chapters 3–8** — Books/reviews API, MongoDB, Docker, CDK/Fargate, CI/CD |
+| [sample-fastapi-graphql-book-api-mcp](./sample-fastapi-graphql-book-api-mcp/) | **Chapter 9** — Same API with MCP tools (`fastapi-mcp`, REST routes exposed to agents) |
 
+Each folder has its own `README` with environment variables, Docker notes, and deploy steps.
 
-## Tooling
+## Prerequisites
 
 - Python **3.12** (see each project’s `.python-version`)
-- Dependencies via **[uv](https://docs.astral.sh/uv/)** (`uv.lock` in each project)
-- AWS CDK CLI **>= 2.1124.1** where CDK is used
+- **[uv](https://docs.astral.sh/uv/)** for installs (`uv sync` in each project directory)
+- **Docker** (for MongoDB and container builds in the book API projects)
+- **AWS CDK CLI** `>= 2.1124.1` when you reach the deploy chapters
 
 ## Quick start
 
+### Chapter 2 starter
+
 ```bash
-# Starter (Chapter 2)
 cd sample-fastapi-graphql-starter-project
 uv sync --all-groups
 uv run pytest tests
 uv run python main.py
+```
+
+Open GraphiQL at `http://127.0.0.1:8000/graph` (see that project’s README).
+
+### Book API (main example)
 
-# Book API
+```bash
 cd sample-fastapi-graphql-book-api
 uv sync --all-groups
+docker compose up mongo   # in another terminal
 uv run pytest tests
+uv run uvicorn main:app --reload
+```
+
+Copy or create a `.env` file using the variables listed in [sample-fastapi-graphql-book-api/README.MD](./sample-fastapi-graphql-book-api/README.MD).
+
+### Book API + MCP (Chapter 9)
+
+```bash
+cd sample-fastapi-graphql-book-api-mcp
+uv sync --all-groups
+docker compose up mongo
+uv run uvicorn main:app --reload
 ```
 
-## Publishing checklist
+See [sample-fastapi-graphql-book-api-mcp/README.MD](./sample-fastapi-graphql-book-api-mcp/README.MD) for MCP Inspector setup.
+
+## Related repos
+
+The **Node.js** book in this series uses a different repository: [serverless-nodejs-dev](https://github.com/CloudBytesCollection/serverless-nodejs-dev) (`sample-aws-starter-project`, `sample-aws-book-api`). Those projects are not part of this Python repo.
+
+## License
 
-1. Push this directory to `github.com/CloudBytesCollection/serverless-python-dev`.
-2. Ensure each subproject’s CI workflows pass on `main`.
-3. Book **Resources** should link to this monorepo (not the Node `sample-aws-starter-project` repo).
+Each subproject includes its own license file (typically BSD 3-Clause). See the folder you are working in.

python_book.jpg

@@ -6,7 +6,7 @@
 [![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/release/python-3120/)
 
 
-Book API with **GraphQL**, **REST**, and **MCP** ([fastapi-mcp](https://github.com/tadata-org/fastapi_mcp)) — Chapter 9 of [*Building Serverless Python Apps Using FastAPI and AWS*](https://www.amazon.com/dp/B09Z7CSDRX).
+Book API with **GraphQL**, **REST**, and **MCP** ([fastapi-mcp](https://github.com/tadata-org/fastapi_mcp)) — Chapter 9 of **Building Serverless Python Apps on AWS**.
 
 Based on [sample-fastapi-graphql-book-api](../sample-fastapi-graphql-book-api/) with REST routes annotated for MCP tools (`operation_id`, `description`).
 

sample-fastapi-graphql-book-api-mcp/README.MD

@@ -8,7 +8,7 @@
 
 A sample python book-api project using FastAPI and GraphQL. This project leverages docker for containerization and provides the full setup to deploy to AWS Fargate using AWS CDK.
 
-Part of the [serverless-python-dev](https://github.com/CloudBytesCollection/serverless-python-dev) monorepo for [*Building Serverless Python Apps Using FastAPI and AWS*](https://www.amazon.com/dp/B09Z7CSDRX) by [Eidan J. Rosado](https://eidanrosado.com). Chapter 2 starter: [sample-fastapi-graphql-starter-project](../sample-fastapi-graphql-starter-project/).
+Part of the [serverless-python-dev](https://github.com/CloudBytesCollection/serverless-python-dev) monorepo for **Building Serverless Python Apps on AWS** by [Eidan J. Rosado](https://eidanrosado.com). Chapter 2 starter: [sample-fastapi-graphql-starter-project](../sample-fastapi-graphql-starter-project/).
 
 ### Running Services with Docker
 To avoid setting up MongoDB and other such services locally, the team uses Docker. You'll need to install Docker to proceed pulling the image from the team's hub. Contact one of the team admins for access to the hub. To start peripheral services simply execute the following:

sample-fastapi-graphql-book-api/README.MD

@@ -7,7 +7,7 @@
 
 A python starter project using FastAPI and GraphQL. This project leverages docker for containerization and was the initial foundation for the complete project in [sample-fastapi-graphql-book-api](../sample-fastapi-graphql-book-api/).
 
-Part of the [serverless-python-dev](https://github.com/CloudBytesCollection/serverless-python-dev) monorepo for [*Building Serverless Python Apps Using FastAPI and AWS*](https://www.amazon.com/dp/B09Z7CSDRX) by [Eidan J. Rosado](https://eidanrosado.com).
+Part of the [serverless-python-dev](https://github.com/CloudBytesCollection/serverless-python-dev) monorepo for **Building Serverless Python Apps on AWS** by [Eidan J. Rosado](https://eidanrosado.com).
 
 ### Running Services with Docker
 To avoid setting up MongoDB and other such services locally, the team uses Docker. You'll need to install Docker to proceed pulling the image from the team's hub. Contact one of the team admins for access to the hub. To start peripheral services simply execute the following: