Seeed-Jetson-DevelopTool / alwaysai-setup
CLAUDE.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.
In this repository297 other files it gives its agents.
- AGENTS.mdAGENTS.md
- ai-nvrAGENTS.md
- allxon-ota-updateAGENTS.md
- allxon-setupAGENTS.md
- alwaysai-setupAGENTS.md
- backup-restoreAGENTS.md
- bsp-source-buildAGENTS.md
- clawdbot-developmentAGENTS.md
- cochl-sense-setupAGENTS.md
- cvedia-setupAGENTS.md
- dashcamnet-xavier-nx-multicameraAGENTS.md
- deciai-setupAGENTS.md
- deepseek-quick-deployAGENTS.md
- deploy-deepseek-mlcAGENTS.md
- deploy-depth-anything-v3AGENTS.md
- deploy-diaAGENTS.md
- deploy-efficient-vision-engineAGENTS.md
- deploy-frigateAGENTS.md
- deploy-live-vlm-webuiAGENTS.md
- deploy-nvbloxAGENTS.md
- deploy-ollama-anythingllmAGENTS.md
- deploy-riva-llama2AGENTS.md
- developtool-deviceAGENTS.md
- disk-encryptionAGENTS.md
- diy-bsp-buildAGENTS.md
- ethercat-communicationAGENTS.md
- ethercat-setupAGENTS.md
- finetune-llm-llama-factoryAGENTS.md
- fix-browser-snap-jetsonAGENTS.md
- gapi-setupAGENTS.md
- generative-ai-introAGENTS.md
- gpt-oss-liveAGENTS.md
- gr00t-n1-5-deploy-thorAGENTS.md
- gr00t-n1-6-deploy-agxAGENTS.md
- hardhat-setupAGENTS.md
- hybrid-bsp-dk-to-recomputerAGENTS.md
- imx477-a603-setupAGENTS.md
- j501-viola-fruit-sortingAGENTS.md
- jetpack5-ssd-boot-fixAGENTS.md
- jetpack-flash-wsl2AGENTS.md
- jetpack-jetson-overviewAGENTS.md
- jetpack-ota-updateAGENTS.md
- jetson-ai-toolsAGENTS.md
- jetson-docker-setupAGENTS.md
- jetson-faqAGENTS.md
- jetson-pc-wired-shareAGENTS.md
- jetson-project-galleryAGENTS.md
- jetson-resource-indexAGENTS.md
- jetson-tutorial-exercisesAGENTS.md
- ko-module-buildAGENTS.md
- l4t-differencesAGENTS.md
- langchain-output-formattingAGENTS.md
- lerobot-env-setupAGENTS.md
- llama-cpp-rpc-distributedAGENTS.md
- llm-interface-controlAGENTS.md
- local-chatbot-multimodalAGENTS.md
- local-chatbot-physicalAGENTS.md
- local-llm-text-to-imageAGENTS.md
- local-rag-llamaindexAGENTS.md
- lumeo-setupAGENTS.md
- The first 60 shown.
The file
We split this CLAUDE.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
- Distinctive: line 19
Run one phase at a time. After each phase:
- Very specific: line 20
If output contains [STOP] → stop immediately, consult the failure decision tree
- Very specific: line 21
If output ends with [OK] → tell the user "Phase N complete" and proceed
- Distinctive: line 78
Create a new project: Dashboard → New Project → Object Detection
- Very specific: line 79
Delete the default mobilenet_ssd model (not optimized for Jetson)
- Very specific: line 80
Add optimized model: Model Catalog → search ssd_mobilenet_v1_coco_2018_01_28_xavier_nx → Add To Project
- Very specific: line 96
Add Jetson device: enter <username>@<jetson_ip>
- Very specific: line 112
If errors → try aai app install --clean.
≈ “Common” is an estimate: at least 1 in 5 of the 26,980 CLAUDE.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.
Files
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.6ls /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:
- Download and install alwaysAI from https://alwaysai.co/installer/windows (or Mac/Linux equivalent)
- Verify CLI:
aai -v- 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 $USERLog out and back in, then verify:
docker run hello-world[OK] when hello-world runs without sudo.
Phase 4 — create account & project (human action)
- Sign up at https://console.alwaysai.co/auth?register=true
- Create a new project: Dashboard → New Project → Object Detection
- Delete the default
mobilenet_ssdmodel (not optimized for Jetson) - 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 startOpen 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
| Symptom | Action |
aai app install fails | Try aai app install --clean. Verify JetPack 4.6 with SDK components. |
| Docker permission denied on Jetson | Run sudo usermod -aG docker $USER, log out and back in. |
| SSH connection refused | Verify Jetson IP, ensure SSH is enabled (sudo systemctl enable ssh). |
| Low FPS with default model | Switch to TensorRT-optimized model as described in Phase 4. |
| Camera not found | Check camera index in app.py (cam=0). Try different indices. |
aai command not found | Reinstall alwaysAI CLI. Check PATH. |
Reference files
references/source.body.md— Original Seeed wiki with screenshots, model catalog details, and enterprise edition info
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
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.

