Skip to content

Commit 2af8b7a

Browse files
Merge pull request #1779 from ArmDeveloperEcosystem/main
Production update
2 parents 5927a7d + 79d5df0 commit 2af8b7a

File tree

19 files changed

+850
-122
lines changed

19 files changed

+850
-122
lines changed

assets/contributors.csv

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,3 +82,4 @@ Odin Shen,Arm,odincodeshen,odin-shen-lmshen,,
8282
Avin Zarlez,Arm,AvinZarlez,avinzarlez,,https://www.avinzarlez.com/
8383
Shuheng Deng,Arm,,,,
8484
Yiyang Fan,Arm,,,,
85+
Geremy Cohen,Arm,geremyCohen,,,
460 KB
Loading
Lines changed: 146 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,146 @@
1+
---
2+
title: Amazon Q Developer CLI
3+
4+
draft: true
5+
6+
author: Jason Andrews
7+
minutes_to_complete: 10
8+
official_docs: https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line.html
9+
10+
test_maintenance: true
11+
test_images:
12+
- ubuntu:latest
13+
14+
layout: installtoolsall
15+
multi_install: false
16+
multitool_install_part: false
17+
tool_install: true
18+
weight: 1
19+
---
20+
21+
Amazon Q Developer for the command line is a CLI tool for Amazon Q, a generative artificial intelligence (AI) powered assistant. You can use it to ask questions about AWS architecture and resources in addition to general developer tasks.
22+
23+
It is available for a variety of operating systems and Linux distributions, supports the Arm architecture, and has multiple ways to install it.
24+
25+
## What should I do before installing Amazon Q Developer CLI?
26+
27+
You need a Builder ID to use the Amazon Q Developer CLI. If you don't have one, visit [Do more with AWS Builder ID](https://community.aws/builderid) and use the Sign up button to create your Builder ID.
28+
29+
This guide explains how to install the latest version of the Amazon Q Developer CLI on computers running Arm Linux and macOS.
30+
31+
## How do I download and install Amazon Q Developer CLI?
32+
33+
The CLI is invoked with the `q` command, and you can install it on macOS and Arm Linux.
34+
35+
### How do I install the Q CLI on macOS?
36+
37+
Install [Homebrew](https://brew.sh/) if it is not already available on your computer.
38+
39+
Install the Q CLI:
40+
41+
```console
42+
brew install amazon-q
43+
```
44+
45+
### How do I install the Q CLI on Arm Linux?
46+
47+
The easiest way to install the latest version of the Q CLI for any Arm Linux distribution is to download and run the installer.
48+
49+
Before starting, make sure `curl` and `unzip` are available on your computer.
50+
51+
The commands for Debian-based distributions such as Ubuntu are below. For other Linux distributions use the package manager to install `curl` and `unzip`.
52+
53+
```bash { target="ubuntu:latest" }
54+
sudo apt update
55+
sudo apt install curl unzip -y
56+
```
57+
58+
Download the zip file with `curl`:
59+
60+
```bash { target="ubuntu:latest" }
61+
curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-aarch64-linux.zip" -o "q.zip"
62+
```
63+
64+
Extract the installer and run it:
65+
66+
```console
67+
unzip q.zip
68+
bash ./q/install.sh
69+
```
70+
71+
Answer the question about updating your shell config.
72+
73+
```output
74+
✔ Do you want q to modify your shell config (you will have to manually do this otherwise)?
75+
```
76+
77+
To automate the install add the `--no-confirm` flag to the `install.sh` command.
78+
79+
{{% notice Note %}}
80+
If you have a Linux distribution with an older version of the GNU C Library or one which does not use the GNU C Library such as Alpine Linux, you can download an alternative package which uses the musl C library and has no external dependencies.
81+
82+
Substitute the `curl` command above with this one and use the same install instructions:
83+
84+
```bash { target="ubuntu:latest" }
85+
curl "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-aarch64-linux-musl.zip" -o "q.zip"
86+
```
87+
88+
{{% /notice %}}
89+
90+
### How do I confirm the Q CLI is working?
91+
92+
You now have the latest version of the Amazon Q Developer CLI installed.
93+
94+
Confirm the CLI is available by invoking the `q` command to print the version.
95+
96+
```console
97+
q version
98+
```
99+
100+
The version is printed:
101+
102+
```output
103+
q 1.7.2
104+
```
105+
106+
## How can I configure my AWS account to get the most from the Q CLI?
107+
108+
The Q CLI can answer questions and solve problems related to your AWS resources and help you develop faster on AWS. To get the maximum benefit, you can configure the AWS CLI to use your account.
109+
110+
Follow the [AWS CLI install guide](/install-guides/aws_access_keys/) and the [AWS Credentials install guide](/install-guides/aws_access_keys/) to set up the AWS CLI and generate and configure access keys.
111+
112+
This allows you to use the Amazon Q Developer CLI to ask questions and solve issues specific to your AWS account.
113+
114+
## What is an example of using the Q CLI?
115+
116+
You can use `q chat` to find information about your AWS resources.
117+
118+
```console
119+
q chat
120+
```
121+
122+
When the chat session starts you see:
123+
124+
```output
125+
Hi, I'm Amazon Q. Ask me anything.
126+
127+
Things to try
128+
• Fix the build failures in this project.
129+
• List my s3 buckets in us-west-2.
130+
• Write unit tests for my application.
131+
• Help me understand my git status
132+
133+
/acceptall Toggles acceptance prompting for the session.
134+
/profile (Beta) Manage profiles for the chat session
135+
/context (Beta) Manage context files for a profile
136+
/help Show the help dialogue
137+
/quit Quit the application
138+
```
139+
140+
For example, you can ask for the IP address of an EC2 instance instead of going to the AWS console or looking up the AWS CLI command to get it.
141+
142+
An example is shown below:
143+
144+
![Connect #center](/install-guides/_images/q.gif)
145+
146+
You are ready to use the Q CLI.

content/learning-paths/servers-and-cloud-computing/_index.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ maintopic: true
99
operatingsystems_filter:
1010
- Android: 2
1111
- Baremetal: 1
12-
- Linux: 132
12+
- Linux: 133
1313
- macOS: 10
1414
- Windows: 14
1515
pinned_modules:
@@ -23,7 +23,7 @@ subjects_filter:
2323
- Containers and Virtualization: 27
2424
- Databases: 15
2525
- Libraries: 8
26-
- ML: 23
26+
- ML: 24
2727
- Performance and Architecture: 48
2828
- Storage: 1
2929
- Web: 10
@@ -71,7 +71,7 @@ tools_software_languages_filter:
7171
- Coding: 18
7272
- conda: 1
7373
- Daytona: 1
74-
- Demo: 3
74+
- Demo: 4
7575
- Django: 1
7676
- Docker: 17
7777
- Envoy: 2
@@ -89,7 +89,7 @@ tools_software_languages_filter:
8989
- GitLab: 1
9090
- Glibc: 1
9191
- Go: 2
92-
- Google Axion: 2
92+
- Google Axion: 3
9393
- GoogleTest: 1
9494
- HammerDB: 1
9595
- Herd7: 1
@@ -123,8 +123,8 @@ tools_software_languages_filter:
123123
- PAPI: 1
124124
- perf: 4
125125
- PostgreSQL: 4
126-
- Python: 24
127-
- PyTorch: 7
126+
- Python: 25
127+
- PyTorch: 8
128128
- RAG: 1
129129
- Redis: 3
130130
- Remote.It: 2
@@ -135,7 +135,7 @@ tools_software_languages_filter:
135135
- Snort3: 1
136136
- SQL: 7
137137
- Streamline CLI: 1
138-
- Streamlit: 1
138+
- Streamlit: 2
139139
- Supervisor: 1
140140
- SVE: 3
141141
- SVE2: 1

content/learning-paths/servers-and-cloud-computing/glibc-with-lse/build_glibc_with_lse.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,17 @@ weight: 2 # (intro is 1), 2 is first, 3 is second, etc.
88
layout: "learningpathall"
99
---
1010

11-
1211
## Overview
12+
1313
"Glibc with LSE" refers to the version of [the GNU C Library (glibc)](https://www.gnu.org/software/libc/) that includes support for [LSE (Large Systems Extensions)](https://learn.arm.com/learning-paths/servers-and-cloud-computing/lse/). LSE is an extension to the ARMv8-A architecture that provides enhanced atomic operations and memory model features.
1414

1515
LSE introduces additional atomic instructions and operations, such as Load-Acquire, Store-Release, and Atomic Compare-and-Swap (CAS). These operations allow for more efficient synchronization and concurrent access to shared memory in multi-threaded applications running on ARMv8-A processors.
1616

1717
When glibc is compiled with LSE support, it can take advantage of these enhanced atomic operations provided by the LSE extension. This can potentially improve the performance of multi-threaded applications that heavily rely on atomic operations and synchronization primitives.
1818

19-
{{% notice Note %}}
19+
{{% notice Warning %}}
20+
If you have a recent version of Linux, you probably do not need to change your GNU C Library.
21+
2022
Your version of the GNU C Library may already have support for LSE. Before you build a new version check if LSE is already included by running:
2123

2224
```console
@@ -25,6 +27,8 @@ objdump -d /lib/aarch64-linux-gnu/libc.so.6 | grep -i 'cas\|casp\|swp\|ldadd\|st
2527

2628
If a non-zero number is printed your GNU C Library already has LSE.
2729

30+
Most recent Linux distributions, including Ubuntu 22.04 and Ubuntu 24.04, already have LSE included in the GNU C Library.
31+
2832
{{% /notice %}}
2933

3034
## Before you begin
@@ -39,6 +43,12 @@ sudo apt install -y gcc-10 g++-10 gawk bison make
3943
```
4044

4145
## Build and Install Glibc
46+
47+
48+
{{% notice Danger %}}
49+
Incorrectly modifying the GNU C Library on your system may result in failing applications or complete system failure. You should use a temporary virtual machine which can be deleted if problems occur.
50+
{{% /notice %}}
51+
4252
You can now checkout the glibc source package and create a build directory:
4353

4454
```bash
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
title: Deploy a LLM based Vision Chatbot with PyTorch and Hugging Face Transformers on Google Axion processors
3+
4+
draft: true
5+
cascade:
6+
draft: true
7+
8+
minutes_to_complete: 45
9+
10+
who_is_this_for: This Learning Path is for software developers, ML engineers, and those who are interested to deploy production-ready vision chatbot for their application with optimized performance on Arm Architecture.
11+
12+
learning_objectives:
13+
- Download PyTorch and Torch AO.
14+
- Install required dependencies
15+
- Build frontend with Streamlit to input image and prompt.
16+
- Build backend to download the Llama 3.2 Vision model, Quantize and run it using PyTorch and Transformers.
17+
- Monitor and analyze inference on Arm CPUs.
18+
19+
prerequisites:
20+
- A Google Cloud Axion compute instance or [any Arm based instance](/learning-paths/servers-and-cloud-computing/csp/) from a cloud service provider with atleast 32 cores.
21+
- Basic understanding of Python and ML concepts.
22+
- Familiarity with REST APIs and web services.
23+
- Basic knowledge on Streamlit.
24+
- Understanding of LLM fundamentals.
25+
26+
author: Nobel Chowdary Mandepudi
27+
28+
### Tags
29+
skilllevels: Advanced
30+
armips:
31+
- Neoverse
32+
subjects: ML
33+
operatingsystems:
34+
- Linux
35+
tools_software_languages:
36+
- Python
37+
- PyTorch
38+
- Streamlit
39+
- Google Axion
40+
- Demo
41+
42+
further_reading:
43+
- resource:
44+
title: Getting started with Llama
45+
link: https://llama.meta.com/get-started
46+
type: documentation
47+
- resource:
48+
title: Hugging Face Documentation
49+
link: https://huggingface.co/docs
50+
type: documentation
51+
- resource:
52+
title: Democratizing Generative AI with CPU-based inference
53+
link: https://blogs.oracle.com/ai-and-datascience/post/democratizing-generative-ai-with-cpu-based-inference
54+
type: blog
55+
56+
57+
58+
### FIXED, DO NOT MODIFY
59+
# ================================================================================
60+
weight: 1 # _index.md always has weight of 1 to order correctly
61+
layout: "learningpathall" # All files under learning paths have this same wrapper
62+
learning_path_main_page: "yes" # This should be surfaced when looking for related content. Only set for _index.md of learning path content.
63+
---
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
# ================================================================================
3+
# FIXED, DO NOT MODIFY THIS FILE
4+
# ================================================================================
5+
weight: 21 # Set to always be larger than the content in this path to be at the end of the navigation.
6+
title: "Next Steps" # Always the same, html page title.
7+
layout: "learningpathall" # All files under learning paths have this same wrapper for Hugo processing.
8+
---

0 commit comments

Comments
 (0)