env and login

Author: heyglassy

README.md

@@ -7,7 +7,7 @@
   <a href="https://x.com/rfgarcia"><img src="https://img.shields.io/twitter/follow/rfgarcia" alt="Follow @rfgarcia"></a>
 </p>
 
-A CLI tool to create the scaffolding for a  new Kernel applications. This tool helps you get started with building browser automation applications using Kernel's platform.
+A CLI tool to create the scaffolding for a new Kernel applications. This tool helps you get started with building browser automation applications using Kernel's platform.
 
 ## Features
 
@@ -52,30 +52,36 @@ create-kernel-app [app-name] [options]
 ### Examples
 
 Create a TypeScript application with a sample app:
+
 ```bash
 npx @onkernel/create-kernel-app my-app --language typescript --template sample-app
 ```
 
 Create a Typescript application with Stagehand template:
+
 ```bash
 npx @onkernel/create-kernel-app my-app --language typescript --template stagehand
 ```
 
 Create a Typescript application with Computer Use template:
+
 ```bash
 npx @onkernel/create-kernel-app my-app --language typescript --template computer-use
 ```
 
 Create a Python application with a sample app:
+
 ```bash
 npx @onkernel/create-kernel-app my-app --language python --template sample-app
 ```
 
 Create a Python application with Browser Use template:
+
 ```bash
 npx @onkernel/create-kernel-app my-app --language python --template browser-use
 ```
-```
+
+````
 
 ## Next Steps
 
@@ -84,18 +90,21 @@ After creating your application:
 1. Navigate to your project directory:
 ```bash
 cd my-app
-```
+````
 
 2. Set up your environment:
+
 - For TypeScript: `npm install`
 - For Python: `uv venv && source .venv/bin/activate && uv sync`
 
 3. Set your Kernel API key:
+
 ```bash
-export KERNEL_API_KEY=<YOUR_API_KEY>
+kernel login  # or: export KERNEL_API_KEY=<YOUR_API_KEY>
 ```
 
 4. Deploy your application:
+
 ```bash
 # Typscript
 kernel deploy index.ts  # --env OPENAI_API_KEY=XXX if Stagehand; --env ANTHROPIC_API_KEY=XXX if Computer Use
@@ -107,6 +116,7 @@ kernel deploy main.py   # --env OPENAI_API_KEY=XXX if Browser Use
 If deploying an app that requires environment variables, make sure to [set them](https://docs.onkernel.com/launch/deploy#environment-variables) when you `deploy`.
 
 5. Invoke your application:
+
 ```bash
 # Typescript + Sample App
 kernel invoke ts-basic get-page-title --payload '{"url": "https://www.google.com"}'
@@ -134,18 +144,19 @@ kernel invoke python-cua cua-task --payload '{"task": "Get current market price
 
 These are the sample apps currently available when you run `npx @onkernel/create-kernel-app`:
 
-| Template | Description | Framework | Query Parameters |
-|----------|-------------|-----------|------------------|
-| **sample-app** | Returns the page title of a specified URL | Playwright | `{ url }` |
-| **browser-use** | Completes a specified task | Browser Use | `{ task }` |
-| **stagehand** | Returns the first result of a specified Google search | Stagehand | `{ query }` |
-| **advanced-sample** | Implements sample apps using advanced Kernel configs | n/a |
-| **computer-use** | Implements a prompt loop | Anthropic Computer Use API | `{ query }` |
-| **cua** | Implements the OpenAI Computer Using Agent (CUA) | OpenAI CUA | `{ task }` |
+| Template            | Description                                           | Framework                  | Query Parameters |
+| ------------------- | ----------------------------------------------------- | -------------------------- | ---------------- |
+| **sample-app**      | Returns the page title of a specified URL             | Playwright                 | `{ url }`        |
+| **browser-use**     | Completes a specified task                            | Browser Use                | `{ task }`       |
+| **stagehand**       | Returns the first result of a specified Google search | Stagehand                  | `{ query }`      |
+| **advanced-sample** | Implements sample apps using advanced Kernel configs  | n/a                        |
+| **computer-use**    | Implements a prompt loop                              | Anthropic Computer Use API | `{ query }`      |
+| **cua**             | Implements the OpenAI Computer Using Agent (CUA)      | OpenAI CUA                 | `{ task }`       |
 
 ## Documentation
 
 For more information about Kernel and its features, visit:
+
 - [Kernel Documentation](https://docs.onkernel.com/quickstart)
 - [Kernel Homepage](https://onkernel.com)
 
@@ -156,4 +167,3 @@ Contributions are welcome! Please feel free to submit a pull request. See [Contr
 ## License
 
 MIT © [Kernel](https://onkernel.com)
-

index.ts

@@ -379,11 +379,11 @@ function printNextSteps(
 Next steps:
   brew install onkernel/tap/kernel
   cd ${appName}
-  kernel login
+  kernel login  # or: export KERNEL_API_KEY=<YOUR_API_KEY>
   ${deployCommand}
   ${INVOKE_SAMPLES[language][template]}
   # Do this in a separate tab
-  kernel login
+  kernel login  # or: export KERNEL_API_KEY=<YOUR_API_KEY>
   kernel logs ${REGISTERED_APP_NAMES[language][template]} --follow
   `)
   );

templates/python/advanced-sample/main.py

@@ -15,7 +15,7 @@
     None
     
 Invoke this via CLI:
-    kernel login
+    kernel login  # or: export KERNEL_API_KEY=<your_api_key>
     kernel deploy main.py  # If you haven't already deployed this app
     kernel invoke py-advanced test_captcha_solver
     kernel logs py-advanced -f  # Open in separate tab
@@ -36,7 +36,7 @@ async def test_captcha_solver(ctx: kernel.KernelContext) -> None:
         page = context.pages[0] if context.pages else await context.new_page()
 
         # Access the live view. Retrieve this live_view_url from the Kernel logs in your CLI:
-        # kernel login
+        # kernel login  # or: export KERNEL_API_KEY=<Your API key>
         # kernel logs py-advanced --follow
         print("Kernel browser live view url: ", kernel_browser.browser_live_view_url)
 

templates/python/cua/main.py

@@ -15,7 +15,7 @@
 Returns:
     An answer to the task, elapsed time and optionally the messages stack
 Invoke this via CLI:
-    kernel login
+    kernel login  # or: export KERNEL_API_KEY=<your_api_key>
     kernel deploy main.py -e OPENAI_API_KEY=XXXXX --force
     kernel invoke python-cua cua-task -p '{"task":"go to https://news.ycombinator.com and list top 5 articles"}'
     kernel logs python-cua -f # Open in separate tab

templates/python/sample-app/main.py

@@ -17,7 +17,7 @@
 Returns:
     A dictionary containing the page title
 Invoke this via CLI:
-    kernel login
+    kernel login  # or: export KERNEL_API_KEY=<your_api_key>
     kernel deploy main.py # If you haven't already deployed this app
     kernel invoke python-basic get-page-title -p '{"url": "https://www.google.com"}'
     kernel logs python-basic -f # Open in separate tab
@@ -74,7 +74,7 @@ async def get_page_title(ctx: kernel.KernelContext, input_data: PageTitleInput)
 Returns:
     A dictionary containing the browser live view url
 Invoke this via CLI:
-    kernel login
+    kernel login  # or: export KERNEL_API_KEY=<your_api_key>
     kernel deploy main.py # If you haven't already deployed this app
     kernel invoke python-basic create-persisted-browser
     kernel logs python-basic -f # Open in separate tab

templates/typescript/advanced-sample/index.ts

@@ -15,7 +15,7 @@ const app = kernel.app("ts-advanced");
  *     None
  *
  * Invoke this via CLI:
- *  kernel login
+ *  kernel login  # or: export KERNEL_API_KEY=<your_api_key>
  *  kernel deploy index.ts # If you haven't already deployed this app
  *  kernel invoke ts-advanced test-captcha-solver
  *  kernel logs ts-advanced -f # Open in separate tab
@@ -31,7 +31,7 @@ app.action("test-captcha-solver", async (ctx: KernelContext): Promise<void> => {
   const browser = await chromium.connectOverCDP(kernelBrowser.cdp_ws_url);
 
   // Access the live view. Retrieve this live_view_url from the Kernel logs in your CLI:
-  // kernel login
+  // kernel login  # or: export KERNEL_API_KEY=<Your API key>
   // kernel logs ts-advanced --follow
   console.log(
     "Kernel browser live view url: ",

templates/typescript/cua/index.ts

@@ -28,7 +28,7 @@ if (!process.env.OPENAI_API_KEY) {
  * Returns:
  *     An answer to the task, elapsed time and optionally the messages stack
  * Invoke this via CLI:
- *  kernel login
+ *  kernel login  # or: export KERNEL_API_KEY=<your_api_key>
  *  kernel deploy index.ts -e OPENAI_API_KEY=XXXXX --force
  *  kernel invoke ts-cua cua-task -p "{\"task\":\"current market price range for a used dreamcast\"}"
  *  kernel logs ts-cua -f # Open in separate tab

templates/typescript/sample-app/index.ts

@@ -13,7 +13,7 @@ const app = kernel.app("ts-basic");
  * Returns:
  *     A dictionary containing the page title
  * Invoke this via CLI:
- *  kernel login
+ *  kernel login  # or: export KERNEL_API_KEY=<your_api_key>
  *  kernel deploy index.ts # If you haven't already deployed this app
  *  kernel invoke ts-basic get-page-title -p '{"url": "https://www.google.com"}'
  *  kernel logs ts-basic -f # Open in separate tab
@@ -85,7 +85,7 @@ app.action<PageTitleInput, PageTitleOutput>(
  * Returns:
  *     A dictionary containing the browser live view url
  * Invoke this via CLI:
- *  kernel login
+ *  kernel login  # or: export KERNEL_API_KEY=<your_api_key>
  *  kernel deploy index.ts # If you haven't already deployed this app
  *  kernel invoke ts-basic create-persisted-browser
  *  kernel logs ts-basic -f # Open in separate tab