py-serverless-kit 0.1.0__tar.gz → 0.1.3__tar.gz

{py_serverless_kit-0.1.0 → py_serverless_kit-0.1.3}/.gitignore

@@ -1,28 +1,29 @@
-# Python
-__pycache__/
-*.py[cod]
-*.egg-info/
-.venv/
-venv/
-build/
-dist/
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-.coverage
-htmlcov/
-.pypirc
-# py-serverless-kit working dirs (local terraform state, artifacts)
-.pskit/
-.terraform/
-*.tfstate
-*.tfstate.*
-
-# Secrets
-.env
-.pypirc
-
-# Editors / OS
-.idea/
-.vscode/
-.DS_Store
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+CLAUDE.md
+build/
+dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.pypirc
+# py-serverless-kit working dirs (local terraform state, artifacts)
+.pskit/
+.terraform/
+*.tfstate
+*.tfstate.*
+
+# Secrets
+.env
+.pypirc
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store

py_serverless_kit-0.1.3/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses [Semantic Versioning](https://semver.org/).
+
+> The function runtime is bundled into every deployment. After upgrading `py-serverless-kit`, run `pskit deploy` again to pick up runtime fixes.
+
+## [Unreleased]
+
+## [0.1.3] - 2026-10-15
+
+### Fixed
+- AWS: `pskit deploy` failed with `creating Lambda Function ...: decomposing request: bufio.Scanner: token too long` once the bundle (e.g. with vendored dependencies) got large, because the zip was sent inline in every `CreateFunction` request. The artifact is now uploaded once to S3 (`aws_s3_object`) and each Lambda function references it via `s3_bucket`/`s3_key`. This also lifts the 50 MB inline upload limit.
+
+### Added
+- AWS options `artifact_bucket` (use an existing bucket for code uploads instead of the private `<service>-<stage>-code-*` bucket pskit creates) and `artifact_upload: s3 | direct` (`direct` restores the old inline upload).
+
+No runtime changes. Existing AWS deployments get a new code bucket on the next `pskit deploy`; Lambda functions are updated in place.
+
+## [0.1.2] - 2026-10-15
+
+### Fixed
+- Python 3.9 support: `pskit package`/`deploy` (and the Cloudflare provider) crashed with `TypeError: write_text() got an unexpected keyword argument 'newline'`, because `Path.write_text(newline=...)` only exists on Python 3.10+. Generated files are now written as UTF-8 bytes with `\n` line endings on every Python version.
+- GCP adapter: the storage object `size` check now narrows `None` explicitly, so mypy passes on Python 3.9 CI. Runtime behavior is unchanged.
+
+No runtime behavior changes: functions deployed with 0.1.1 don't need to be redeployed.
+
+## [0.1.1] - 2026-10-15
+
+### Changed
+- Author and maintainer set to Asif Khan @ Kavion.ai (`py_serverless_kit.__author__`, package metadata, LICENSE).
+- Project URLs (homepage, docs, issues, changelog) now point to https://github.com/ak9347128658/serverless_kit.
+- README links are absolute so they work on the PyPI project page; added CI/PyPI/license badges.
+- `scripts/validate_all_providers.py` explains that Terraform is optional instead of printing a traceback when it isn't installed.
+
+### Added
+- `deploy_docs/How_to_deploy.md`: short PyPI release guide with PowerShell commands and troubleshooting (e.g. TestPyPI `403`).
+- `deploy_docs/HOW_TO_INSTALL_TERRAFORM.md`: installing Terraform on Windows.
+
+No runtime changes: functions deployed with 0.1.0 don't need to be redeployed.
+
+## [0.1.0] - 2026-10-15
+
+### Added
+- Portable handler API: `Event`, `HttpRequest`, `Record`, `Headers`, `Context`, `Response`, HTTP error classes, `BatchResult`, `invoke()`.
+- `pskit.yml` configuration with `extends:`, `providers:` and `stages:` overrides, and `${env:}`, `${opt:}`, `${self:}`, `${file()}` and `${tf:}` variables.
+- Providers: AWS (stable), Google Cloud (stable), Azure (stable), Alibaba Cloud (beta), Huawei Cloud (beta), Tencent Cloud (beta), DigitalOcean (beta), IBM Cloud (beta), Oracle Cloud (experimental), Cloudflare Workers (experimental).
+- Triggers: HTTP (path params, CORS, auth), schedule (rate/cron), queue, storage, topic.
+- Workflows: native AWS Step Functions and Google Cloud Workflows compilers, plus an embedded engine for the other providers and local runs.
+- CLI: `init`, `validate`, `package`, `plan`, `deploy`, `remove`, `info`, `dashboard`, `dev`, `invoke`, `workflow run|show`, `providers`, `tf`.
+- Deployment dashboard (self-contained HTML).
+- Local dev server with hot reload, and `LocalRunner` for tests.
+- `scripts/validate_all_providers.py`, which runs `terraform validate` for every provider.

{py_serverless_kit-0.1.0 → py_serverless_kit-0.1.3}/CONTRIBUTING.md

@@ -1,13 +1,13 @@
-# Contributing
-
-The full contributor guide lives in [deploy_docs/CONTRIBUTING.md](deploy_docs/CONTRIBUTING.md). It covers the project layout, dev setup, how to add providers and options, and how to verify Terraform.
-
-Maintainers releasing to PyPI: see [deploy_docs/PUBLISHING_TO_PYPI.md](deploy_docs/PUBLISHING_TO_PYPI.md).
-
-Quick start:
-
-```bash
-python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\Activate.ps1
-pip install -e ".[dev]"
-pytest && ruff check src tests && mypy
-```
+# Contributing
+
+The full contributor guide lives in [deploy_docs/CONTRIBUTING.md](deploy_docs/CONTRIBUTING.md). It covers the project layout, dev setup, how to add providers and options, and how to verify Terraform.
+
+Maintainers releasing to PyPI: see [deploy_docs/PUBLISHING_TO_PYPI.md](deploy_docs/PUBLISHING_TO_PYPI.md).
+
+Quick start:
+
+```bash
+python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\Activate.ps1
+pip install -e ".[dev]"
+pytest && ruff check src tests && mypy
+```

{py_serverless_kit-0.1.0 → py_serverless_kit-0.1.3}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Asif Khan @ Kavion.ai
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Asif Khan @ Kavion.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{py_serverless_kit-0.1.0 → py_serverless_kit-0.1.3}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.5
 Name: py-serverless-kit
-Version: 0.1.0
+Version: 0.1.3
 Summary: Write a Python serverless function once and deploy it to AWS, Azure, GCP and 7 more clouds with one YAML file, powered by Terraform.
-Project-URL: Homepage, https://github.com/kavion-ai/py-serverless-kit
-Project-URL: Documentation, https://github.com/kavion-ai/py-serverless-kit/tree/main/docs
-Project-URL: Issues, https://github.com/kavion-ai/py-serverless-kit/issues
-Project-URL: Changelog, https://github.com/kavion-ai/py-serverless-kit/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/ak9347128658/serverless_kit
+Project-URL: Documentation, https://github.com/ak9347128658/serverless_kit/tree/main/docs
+Project-URL: Issues, https://github.com/ak9347128658/serverless_kit/issues
+Project-URL: Changelog, https://github.com/ak9347128658/serverless_kit/blob/main/CHANGELOG.md
 Author: Asif Khan @ Kavion.ai
 Maintainer: Asif Khan @ Kavion.ai
 License: MIT
@@ -44,6 +44,10 @@ Description-Content-Type: text/markdown
 
 # py-serverless-kit
 
+[![CI](https://github.com/ak9347128658/serverless_kit/actions/workflows/ci.yml/badge.svg)](https://github.com/ak9347128658/serverless_kit/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/py-serverless-kit.svg)](https://pypi.org/project/py-serverless-kit/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ak9347128658/serverless_kit/blob/main/LICENSE)
+
 **Write your Python functions once. Deploy them to any of 10 clouds by changing one line of YAML.**
 
 `py-serverless-kit` (CLI: `pskit`) is a Serverless-Framework-style toolkit built on **Terraform**. Your handlers use one small, provider-neutral API (`Event`, `Context`, `Response`). A `pskit.yml` file says which cloud they run on and what triggers them: HTTP, schedules, queues, storage, topics. The same file can also define workflows in the style of Step Functions. `pskit deploy` generates Terraform for the chosen cloud, applies it, and builds an HTML dashboard of everything you deployed.
@@ -119,7 +123,7 @@ Teams that build on AWS Lambda and Step Functions end up with code full of API G
 
 Run `pskit providers` for the live matrix. If a config uses a trigger the target cloud can't support, **`pskit validate` fails with a clear message instead of deploying something half-working.**
 
-> **Maturity, honestly stated:** the Terraform generated for every provider is checked with `terraform validate` against the real provider plugins (in CI, too). The *stable* providers cover the most surface area. *beta* and *experimental* providers follow vendor docs for event payloads that `validate` can't check, so try them on a non-production account first. See [docs/providers.md](docs/providers.md) for each provider's details and limits.
+> **Maturity, honestly stated:** the Terraform generated for every provider is checked with `terraform validate` against the real provider plugins (in CI, too). The *stable* providers cover the most surface area. *beta* and *experimental* providers follow vendor docs for event payloads that `validate` can't check, so try them on a non-production account first. See [docs/providers.md](https://github.com/ak9347128658/serverless_kit/blob/main/docs/providers.md) for each provider's details and limits.
 
 ## Install
 
@@ -127,7 +131,7 @@ Run `pskit providers` for the live matrix. If a config uses a trigger the target
 pip install py-serverless-kit
 ```
 
-You also need **Terraform ≥ 1.5** (or OpenTofu) on your `PATH`, plus credentials for your cloud. See [Getting started](docs/getting-started.md#cloud-credentials).
+You also need **Terraform ≥ 1.5** (or OpenTofu) on your `PATH`, plus credentials for your cloud. See [Getting started](https://github.com/ak9347128658/serverless_kit/blob/main/docs/getting-started.md#cloud-credentials).
 
 ## Quick start
 
@@ -243,58 +247,60 @@ The same definition becomes **AWS Step Functions** on AWS, **Google Cloud Workfl
               your result ──► Response / raw value ──► adapter ──► native cloud response
 ```
 
-More: [docs/architecture.md](docs/architecture.md).
+More: [docs/architecture.md](https://github.com/ak9347128658/serverless_kit/blob/main/docs/architecture.md).
 
 ## Examples
 
-Fifteen runnable scenarios live in [`examples/`](examples/). They are tested in CI.
+Fifteen runnable scenarios live in [`examples/`](https://github.com/ak9347128658/serverless_kit/tree/main/examples/). They are tested in CI.
 
 | | |
 |---|---|
-| [01-hello-http](examples/01-hello-http) | Minimal HTTP function |
-| [02-rest-api](examples/02-rest-api) | CRUD, path params, validation errors, CORS, cookies, binary, JWT |
-| [03-scheduled-jobs](examples/03-scheduled-jobs) | rate/cron schedules with input and time zones |
-| [04-queue-worker](examples/04-queue-worker) | Queue consumer, partial batch failures, dead-letter queue |
-| [05-storage-events](examples/05-storage-events) | Object created/deleted with filters |
-| [06-pubsub-topic](examples/06-pubsub-topic) | Topic fan-out and filters |
-| [07-workflow-orders](examples/07-workflow-orders) | Every workflow state type, retry/catch |
-| [08-multi-cloud](examples/08-multi-cloud) | Same code, all 10 providers |
-| [09-function-invoke](examples/09-function-invoke) | Function-to-function `invoke()` |
-| [10-stages-and-config](examples/10-stages-and-config) | Stages, variables, secrets |
-| [11-custom-terraform](examples/11-custom-terraform) | `terraform.extra`, `${tf:...}`, remote state, hooks |
-| [12-async-and-context](examples/12-async-and-context) | async handlers, logging, deadlines |
-| [13-migrate-from-aws-lambda](examples/13-migrate-from-aws-lambda) | Before/after migration of Lambda + Step Functions |
-| [14-testing](examples/14-testing) | Unit-testing handlers and workflows with pytest |
-| [15-ci-cd-deploy](examples/15-ci-cd-deploy) | GitHub Actions deploys per stage |
+| [01-hello-http](https://github.com/ak9347128658/serverless_kit/tree/main/examples/01-hello-http) | Minimal HTTP function |
+| [02-rest-api](https://github.com/ak9347128658/serverless_kit/tree/main/examples/02-rest-api) | CRUD, path params, validation errors, CORS, cookies, binary, JWT |
+| [03-scheduled-jobs](https://github.com/ak9347128658/serverless_kit/tree/main/examples/03-scheduled-jobs) | rate/cron schedules with input and time zones |
+| [04-queue-worker](https://github.com/ak9347128658/serverless_kit/tree/main/examples/04-queue-worker) | Queue consumer, partial batch failures, dead-letter queue |
+| [05-storage-events](https://github.com/ak9347128658/serverless_kit/tree/main/examples/05-storage-events) | Object created/deleted with filters |
+| [06-pubsub-topic](https://github.com/ak9347128658/serverless_kit/tree/main/examples/06-pubsub-topic) | Topic fan-out and filters |
+| [07-workflow-orders](https://github.com/ak9347128658/serverless_kit/tree/main/examples/07-workflow-orders) | Every workflow state type, retry/catch |
+| [08-multi-cloud](https://github.com/ak9347128658/serverless_kit/tree/main/examples/08-multi-cloud) | Same code, all 10 providers |
+| [09-function-invoke](https://github.com/ak9347128658/serverless_kit/tree/main/examples/09-function-invoke) | Function-to-function `invoke()` |
+| [10-stages-and-config](https://github.com/ak9347128658/serverless_kit/tree/main/examples/10-stages-and-config) | Stages, variables, secrets |
+| [11-custom-terraform](https://github.com/ak9347128658/serverless_kit/tree/main/examples/11-custom-terraform) | `terraform.extra`, `${tf:...}`, remote state, hooks |
+| [12-async-and-context](https://github.com/ak9347128658/serverless_kit/tree/main/examples/12-async-and-context) | async handlers, logging, deadlines |
+| [13-migrate-from-aws-lambda](https://github.com/ak9347128658/serverless_kit/tree/main/examples/13-migrate-from-aws-lambda) | Before/after migration of Lambda + Step Functions |
+| [14-testing](https://github.com/ak9347128658/serverless_kit/tree/main/examples/14-testing) | Unit-testing handlers and workflows with pytest |
+| [15-ci-cd-deploy](https://github.com/ak9347128658/serverless_kit/tree/main/examples/15-ci-cd-deploy) | GitHub Actions deploys per stage |
 
 ## Documentation
 
 | | |
 |---|---|
-| [Getting started](docs/getting-started.md) | Install, credentials, first deploy |
-| [Configuration reference](docs/configuration.md) | Every `pskit.yml` key, variables, `extends`, stages |
-| [Events](docs/events.md) | HTTP, schedule, queue, storage, topic, with a per-provider matrix |
-| [Handler API](docs/handlers.md) | `Event`, `Context`, `Response`, errors, `BatchResult`, `invoke()` |
-| [Workflows](docs/workflows.md) | State machine reference, engines, limitations |
-| [Providers](docs/providers.md) | Options, credentials, resources and limits per cloud |
-| [CLI](docs/cli.md) | Every command and flag |
-| [Local development](docs/local-development.md) | `pskit dev`, `invoke`, testing |
-| [Dashboard](docs/dashboard.md) | The deployment UI |
-| [Architecture](docs/architecture.md) | Internals and third-party providers |
-| [Migrating from AWS](docs/migrating-from-aws.md) | Lambda + Step Functions → pskit |
-| [Troubleshooting](docs/troubleshooting.md) | Common errors and fixes |
+| [Getting started](https://github.com/ak9347128658/serverless_kit/blob/main/docs/getting-started.md) | Install, credentials, first deploy |
+| [Configuration reference](https://github.com/ak9347128658/serverless_kit/blob/main/docs/configuration.md) | Every `pskit.yml` key, variables, `extends`, stages |
+| [Events](https://github.com/ak9347128658/serverless_kit/blob/main/docs/events.md) | HTTP, schedule, queue, storage, topic, with a per-provider matrix |
+| [Handler API](https://github.com/ak9347128658/serverless_kit/blob/main/docs/handlers.md) | `Event`, `Context`, `Response`, errors, `BatchResult`, `invoke()` |
+| [Workflows](https://github.com/ak9347128658/serverless_kit/blob/main/docs/workflows.md) | State machine reference, engines, limitations |
+| [Providers](https://github.com/ak9347128658/serverless_kit/blob/main/docs/providers.md) | Options, credentials, resources and limits per cloud |
+| [CLI](https://github.com/ak9347128658/serverless_kit/blob/main/docs/cli.md) | Every command and flag |
+| [Local development](https://github.com/ak9347128658/serverless_kit/blob/main/docs/local-development.md) | `pskit dev`, `invoke`, testing |
+| [Dashboard](https://github.com/ak9347128658/serverless_kit/blob/main/docs/dashboard.md) | The deployment UI |
+| [Architecture](https://github.com/ak9347128658/serverless_kit/blob/main/docs/architecture.md) | Internals and third-party providers |
+| [Migrating from AWS](https://github.com/ak9347128658/serverless_kit/blob/main/docs/migrating-from-aws.md) | Lambda + Step Functions → pskit |
+| [Troubleshooting](https://github.com/ak9347128658/serverless_kit/blob/main/docs/troubleshooting.md) | Common errors and fixes |
 
 ## Contributing & releasing
 
-- Contributor guide: [deploy_docs/CONTRIBUTING.md](deploy_docs/CONTRIBUTING.md)
-- Quick PyPI release guide: [deploy_docs/How_to_deploy.md](deploy_docs/How_to_deploy.md)
-- Publishing to PyPI (step by step): [deploy_docs/PUBLISHING_TO_PYPI.md](deploy_docs/PUBLISHING_TO_PYPI.md)
-- Security policy: [SECURITY.md](SECURITY.md)
+- Contributor guide: [deploy_docs/CONTRIBUTING.md](https://github.com/ak9347128658/serverless_kit/blob/main/deploy_docs/CONTRIBUTING.md)
+- Quick PyPI release guide: [deploy_docs/How_to_deploy.md](https://github.com/ak9347128658/serverless_kit/blob/main/deploy_docs/How_to_deploy.md)
+- Publishing to PyPI (step by step): [deploy_docs/PUBLISHING_TO_PYPI.md](https://github.com/ak9347128658/serverless_kit/blob/main/deploy_docs/PUBLISHING_TO_PYPI.md)
+- Security policy: [SECURITY.md](https://github.com/ak9347128658/serverless_kit/blob/main/SECURITY.md)
 
 ## Author
 
 Created and maintained by **Asif Khan @ [Kavion.ai](https://kavion.ai)**.
 
+Source code, issues and releases: <https://github.com/ak9347128658/serverless_kit>
+
 ## License
 
-MIT, see [LICENSE](LICENSE).
+MIT, see [LICENSE](https://github.com/ak9347128658/serverless_kit/blob/main/LICENSE).

{py_serverless_kit-0.1.0 → py_serverless_kit-0.1.3}/README.md

@@ -1,5 +1,9 @@
 # py-serverless-kit
 
+[![CI](https://github.com/ak9347128658/serverless_kit/actions/workflows/ci.yml/badge.svg)](https://github.com/ak9347128658/serverless_kit/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/py-serverless-kit.svg)](https://pypi.org/project/py-serverless-kit/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ak9347128658/serverless_kit/blob/main/LICENSE)
+
 **Write your Python functions once. Deploy them to any of 10 clouds by changing one line of YAML.**
 
 `py-serverless-kit` (CLI: `pskit`) is a Serverless-Framework-style toolkit built on **Terraform**. Your handlers use one small, provider-neutral API (`Event`, `Context`, `Response`). A `pskit.yml` file says which cloud they run on and what triggers them: HTTP, schedules, queues, storage, topics. The same file can also define workflows in the style of Step Functions. `pskit deploy` generates Terraform for the chosen cloud, applies it, and builds an HTML dashboard of everything you deployed.
@@ -75,7 +79,7 @@ Teams that build on AWS Lambda and Step Functions end up with code full of API G
 
 Run `pskit providers` for the live matrix. If a config uses a trigger the target cloud can't support, **`pskit validate` fails with a clear message instead of deploying something half-working.**
 
-> **Maturity, honestly stated:** the Terraform generated for every provider is checked with `terraform validate` against the real provider plugins (in CI, too). The *stable* providers cover the most surface area. *beta* and *experimental* providers follow vendor docs for event payloads that `validate` can't check, so try them on a non-production account first. See [docs/providers.md](docs/providers.md) for each provider's details and limits.
+> **Maturity, honestly stated:** the Terraform generated for every provider is checked with `terraform validate` against the real provider plugins (in CI, too). The *stable* providers cover the most surface area. *beta* and *experimental* providers follow vendor docs for event payloads that `validate` can't check, so try them on a non-production account first. See [docs/providers.md](https://github.com/ak9347128658/serverless_kit/blob/main/docs/providers.md) for each provider's details and limits.
 
 ## Install
 
@@ -83,7 +87,7 @@ Run `pskit providers` for the live matrix. If a config uses a trigger the target
 pip install py-serverless-kit
 ```
 
-You also need **Terraform ≥ 1.5** (or OpenTofu) on your `PATH`, plus credentials for your cloud. See [Getting started](docs/getting-started.md#cloud-credentials).
+You also need **Terraform ≥ 1.5** (or OpenTofu) on your `PATH`, plus credentials for your cloud. See [Getting started](https://github.com/ak9347128658/serverless_kit/blob/main/docs/getting-started.md#cloud-credentials).
 
 ## Quick start
 
@@ -199,58 +203,60 @@ The same definition becomes **AWS Step Functions** on AWS, **Google Cloud Workfl
               your result ──► Response / raw value ──► adapter ──► native cloud response
 ```
 
-More: [docs/architecture.md](docs/architecture.md).
+More: [docs/architecture.md](https://github.com/ak9347128658/serverless_kit/blob/main/docs/architecture.md).
 
 ## Examples
 
-Fifteen runnable scenarios live in [`examples/`](examples/). They are tested in CI.
+Fifteen runnable scenarios live in [`examples/`](https://github.com/ak9347128658/serverless_kit/tree/main/examples/). They are tested in CI.
 
 | | |
 |---|---|
-| [01-hello-http](examples/01-hello-http) | Minimal HTTP function |
-| [02-rest-api](examples/02-rest-api) | CRUD, path params, validation errors, CORS, cookies, binary, JWT |
-| [03-scheduled-jobs](examples/03-scheduled-jobs) | rate/cron schedules with input and time zones |
-| [04-queue-worker](examples/04-queue-worker) | Queue consumer, partial batch failures, dead-letter queue |
-| [05-storage-events](examples/05-storage-events) | Object created/deleted with filters |
-| [06-pubsub-topic](examples/06-pubsub-topic) | Topic fan-out and filters |
-| [07-workflow-orders](examples/07-workflow-orders) | Every workflow state type, retry/catch |
-| [08-multi-cloud](examples/08-multi-cloud) | Same code, all 10 providers |
-| [09-function-invoke](examples/09-function-invoke) | Function-to-function `invoke()` |
-| [10-stages-and-config](examples/10-stages-and-config) | Stages, variables, secrets |
-| [11-custom-terraform](examples/11-custom-terraform) | `terraform.extra`, `${tf:...}`, remote state, hooks |
-| [12-async-and-context](examples/12-async-and-context) | async handlers, logging, deadlines |
-| [13-migrate-from-aws-lambda](examples/13-migrate-from-aws-lambda) | Before/after migration of Lambda + Step Functions |
-| [14-testing](examples/14-testing) | Unit-testing handlers and workflows with pytest |
-| [15-ci-cd-deploy](examples/15-ci-cd-deploy) | GitHub Actions deploys per stage |
+| [01-hello-http](https://github.com/ak9347128658/serverless_kit/tree/main/examples/01-hello-http) | Minimal HTTP function |
+| [02-rest-api](https://github.com/ak9347128658/serverless_kit/tree/main/examples/02-rest-api) | CRUD, path params, validation errors, CORS, cookies, binary, JWT |
+| [03-scheduled-jobs](https://github.com/ak9347128658/serverless_kit/tree/main/examples/03-scheduled-jobs) | rate/cron schedules with input and time zones |
+| [04-queue-worker](https://github.com/ak9347128658/serverless_kit/tree/main/examples/04-queue-worker) | Queue consumer, partial batch failures, dead-letter queue |
+| [05-storage-events](https://github.com/ak9347128658/serverless_kit/tree/main/examples/05-storage-events) | Object created/deleted with filters |
+| [06-pubsub-topic](https://github.com/ak9347128658/serverless_kit/tree/main/examples/06-pubsub-topic) | Topic fan-out and filters |
+| [07-workflow-orders](https://github.com/ak9347128658/serverless_kit/tree/main/examples/07-workflow-orders) | Every workflow state type, retry/catch |
+| [08-multi-cloud](https://github.com/ak9347128658/serverless_kit/tree/main/examples/08-multi-cloud) | Same code, all 10 providers |
+| [09-function-invoke](https://github.com/ak9347128658/serverless_kit/tree/main/examples/09-function-invoke) | Function-to-function `invoke()` |
+| [10-stages-and-config](https://github.com/ak9347128658/serverless_kit/tree/main/examples/10-stages-and-config) | Stages, variables, secrets |
+| [11-custom-terraform](https://github.com/ak9347128658/serverless_kit/tree/main/examples/11-custom-terraform) | `terraform.extra`, `${tf:...}`, remote state, hooks |
+| [12-async-and-context](https://github.com/ak9347128658/serverless_kit/tree/main/examples/12-async-and-context) | async handlers, logging, deadlines |
+| [13-migrate-from-aws-lambda](https://github.com/ak9347128658/serverless_kit/tree/main/examples/13-migrate-from-aws-lambda) | Before/after migration of Lambda + Step Functions |
+| [14-testing](https://github.com/ak9347128658/serverless_kit/tree/main/examples/14-testing) | Unit-testing handlers and workflows with pytest |
+| [15-ci-cd-deploy](https://github.com/ak9347128658/serverless_kit/tree/main/examples/15-ci-cd-deploy) | GitHub Actions deploys per stage |
 
 ## Documentation
 
 | | |
 |---|---|
-| [Getting started](docs/getting-started.md) | Install, credentials, first deploy |
-| [Configuration reference](docs/configuration.md) | Every `pskit.yml` key, variables, `extends`, stages |
-| [Events](docs/events.md) | HTTP, schedule, queue, storage, topic, with a per-provider matrix |
-| [Handler API](docs/handlers.md) | `Event`, `Context`, `Response`, errors, `BatchResult`, `invoke()` |
-| [Workflows](docs/workflows.md) | State machine reference, engines, limitations |
-| [Providers](docs/providers.md) | Options, credentials, resources and limits per cloud |
-| [CLI](docs/cli.md) | Every command and flag |
-| [Local development](docs/local-development.md) | `pskit dev`, `invoke`, testing |
-| [Dashboard](docs/dashboard.md) | The deployment UI |
-| [Architecture](docs/architecture.md) | Internals and third-party providers |
-| [Migrating from AWS](docs/migrating-from-aws.md) | Lambda + Step Functions → pskit |
-| [Troubleshooting](docs/troubleshooting.md) | Common errors and fixes |
+| [Getting started](https://github.com/ak9347128658/serverless_kit/blob/main/docs/getting-started.md) | Install, credentials, first deploy |
+| [Configuration reference](https://github.com/ak9347128658/serverless_kit/blob/main/docs/configuration.md) | Every `pskit.yml` key, variables, `extends`, stages |
+| [Events](https://github.com/ak9347128658/serverless_kit/blob/main/docs/events.md) | HTTP, schedule, queue, storage, topic, with a per-provider matrix |
+| [Handler API](https://github.com/ak9347128658/serverless_kit/blob/main/docs/handlers.md) | `Event`, `Context`, `Response`, errors, `BatchResult`, `invoke()` |
+| [Workflows](https://github.com/ak9347128658/serverless_kit/blob/main/docs/workflows.md) | State machine reference, engines, limitations |
+| [Providers](https://github.com/ak9347128658/serverless_kit/blob/main/docs/providers.md) | Options, credentials, resources and limits per cloud |
+| [CLI](https://github.com/ak9347128658/serverless_kit/blob/main/docs/cli.md) | Every command and flag |
+| [Local development](https://github.com/ak9347128658/serverless_kit/blob/main/docs/local-development.md) | `pskit dev`, `invoke`, testing |
+| [Dashboard](https://github.com/ak9347128658/serverless_kit/blob/main/docs/dashboard.md) | The deployment UI |
+| [Architecture](https://github.com/ak9347128658/serverless_kit/blob/main/docs/architecture.md) | Internals and third-party providers |
+| [Migrating from AWS](https://github.com/ak9347128658/serverless_kit/blob/main/docs/migrating-from-aws.md) | Lambda + Step Functions → pskit |
+| [Troubleshooting](https://github.com/ak9347128658/serverless_kit/blob/main/docs/troubleshooting.md) | Common errors and fixes |
 
 ## Contributing & releasing
 
-- Contributor guide: [deploy_docs/CONTRIBUTING.md](deploy_docs/CONTRIBUTING.md)
-- Quick PyPI release guide: [deploy_docs/How_to_deploy.md](deploy_docs/How_to_deploy.md)
-- Publishing to PyPI (step by step): [deploy_docs/PUBLISHING_TO_PYPI.md](deploy_docs/PUBLISHING_TO_PYPI.md)
-- Security policy: [SECURITY.md](SECURITY.md)
+- Contributor guide: [deploy_docs/CONTRIBUTING.md](https://github.com/ak9347128658/serverless_kit/blob/main/deploy_docs/CONTRIBUTING.md)
+- Quick PyPI release guide: [deploy_docs/How_to_deploy.md](https://github.com/ak9347128658/serverless_kit/blob/main/deploy_docs/How_to_deploy.md)
+- Publishing to PyPI (step by step): [deploy_docs/PUBLISHING_TO_PYPI.md](https://github.com/ak9347128658/serverless_kit/blob/main/deploy_docs/PUBLISHING_TO_PYPI.md)
+- Security policy: [SECURITY.md](https://github.com/ak9347128658/serverless_kit/blob/main/SECURITY.md)
 
 ## Author
 
 Created and maintained by **Asif Khan @ [Kavion.ai](https://kavion.ai)**.
 
+Source code, issues and releases: <https://github.com/ak9347128658/serverless_kit>
+
 ## License
 
-MIT, see [LICENSE](LICENSE).
+MIT, see [LICENSE](https://github.com/ak9347128658/serverless_kit/blob/main/LICENSE).