agentleFS
Seeed-ProjectsSeeed-Projects/Seeed-Jetson-DevelopTool/skills/codex/alwaysai-setup/AGENTS.md

Seeed-Jetson-DevelopTool / alwaysai-setup

AGENTS.md57 starsChanged 4 months agoMITView on GitHub

Set up the alwaysAI computer vision platform to deploy ML-based object detection on Jetson devices. Supports live camera and video file inference with TensorRT acceleration. Requires JetPack 4.6 and a host PC.

The file

We split this AGENTS.md into the rules it gives an agent

8 rules. About 0 are common, 2 are distinctive, and 6 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 6

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run one phase at a time. After each phase:

    line 19
  2. Very specific:

    If output contains [STOP] → stop immediately, consult the failure decision tree

    line 20
  3. Very specific:

    If output ends with [OK] → tell the user "Phase N complete" and proceed

    line 21
  4. Distinctive:

    Create a new project: Dashboard → New Project → Object Detection

    line 78
  5. Very specific:

    Delete the default mobilenet_ssd model (not optimized for Jetson)

    line 79
  6. Very specific:

    Add optimized model: Model Catalog → search ssd_mobilenet_v1_coco_2018_01_28_xavier_nx → Add To Project

    line 80
  7. Very specific:

    Add Jetson device: enter <username>@<jetson_ip>

    line 96
  8. Very specific:

    If errors → try aai app install --clean.

    line 112

≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
AGENTS.md

alwaysAI on NVIDIA Jetson

alwaysAI is a computer vision development platform for creating and deploying ML applications on edge devices. Deploy object detection projects from a host PC to Jetson via SSH, with TensorRT-optimized models for real-time inference.

Hardware: Jetson device (Nano/Xavier NX/AGX Xavier/AGX Orin), USB webcam or MIPI CSI camera Software: JetPack 4.6 with all SDK components, host PC (Windows/Linux/Mac)


Execution model

Run one phase at a time. After each phase:

  • If output contains [STOP] → stop immediately, consult the failure decision tree
  • If output ends with [OK] → tell the user "Phase N complete" and proceed

Phase 1 — prerequisites check (~30 s)

On Jetson:

sudo apt-cache show nvidia-jetpack
# Confirm JetPack 4.6
ls /dev/video*
# Confirm camera is connected

[OK] when JetPack 4.6 confirmed and camera detected.


Phase 2 — setup host PC (~5 min)

On the development PC:

  1. Download and install alwaysAI from https://alwaysai.co/installer/windows (or Mac/Linux equivalent)
  2. Verify CLI:
aai -v
  1. Verify OpenSSH:
ssh -V

[OK] when aai and ssh both return version numbers.


Phase 3 — setup Jetson environment (~2 min)

On Jetson:

sudo usermod -aG docker $USER

Log out and back in, then verify:

docker run hello-world

[OK] when hello-world runs without sudo.


Phase 4 — create account & project (human action)

  1. Sign up at https://console.alwaysai.co/auth?register=true
  2. Create a new project: Dashboard → New Project → Object Detection
  3. Delete the default mobilenet_ssd model (not optimized for Jetson)
  4. Add optimized model: Model Catalog → search ssd_mobilenet_v1_coco_2018_01_28_xavier_nx → Add To Project

[OK] when project has the TensorRT-optimized model.


Phase 5 — deploy to Jetson (~5 min)

On host PC, create a project folder and configure:

mkdir ~/alwaysai-project && cd ~/alwaysai-project
aai app configure
  • Select your project
  • Choose "Remote device" as destination
  • Add Jetson device: enter <username>@<jetson_ip>
  • Enter Jetson password when prompted

Edit app.py to use the optimized model and TensorRT engine:

def main():
    obj_detect = edgeiq.ObjectDetection("alwaysai/ssd_mobilenet_v1_coco_2018_01_28_xavier_nx")
    obj_detect.load(engine=edgeiq.Engine.TENSOR_RT)

Install the app:

aai app install

[OK] when install completes successfully. If errors → try aai app install --clean.


Phase 6 — run object detection (~1 min)

aai app start

Open browser: http://localhost:5000

Expected: live video feed with detected objects and confidence percentages.

[OK] when detections are visible in the browser.


Failure decision tree

SymptomAction
aai app install failsTry aai app install --clean. Verify JetPack 4.6 with SDK components.
Docker permission denied on JetsonRun sudo usermod -aG docker $USER, log out and back in.
SSH connection refusedVerify Jetson IP, ensure SSH is enabled (sudo systemctl enable ssh).
Low FPS with default modelSwitch to TensorRT-optimized model as described in Phase 4.
Camera not foundCheck camera index in app.py (cam=0). Try different indices.
aai command not foundReinstall alwaysAI CLI. Check PATH.

Reference files

  • references/source.body.md — Original Seeed wiki with screenshots, model catalog details, and enterprise edition info

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.