Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To upload screenshots from a self-hosted runner, first generate image files in your test workflow, then run the Argos CLI against the directory containing them: npx @argos-ci/cli upload ./screenshots. Give the job an Argos project token through ARGOS_TOKEN, unless you are using a supported provider-specific authentication method. The upload step does not capture screenshots for you.

Prepare the runner and screenshot output

Argos’s general upload flow separates screenshot capture from upload. Run your existing Playwright, Cypress, mobile-test, or other capture process first, and make sure it writes files to a known directory. The CLI pattern documented for directory uploads is argos upload ./screenshots. See the Argos CLI documentation for the current command reference.

  1. Capture: Run the test or capture command that creates screenshot files.
  2. Check the path: Confirm the actual output directory and pass that path to the upload command. Change ./screenshots if your workflow writes elsewhere.
  3. Install and run the CLI: Ensure the runner can invoke the Argos CLI. The command below uses npx as an illustrative invocation; installation details depend on your runner image and package-management setup.
  4. Authenticate: For a generic token-based workflow, store the project token as a protected CI secret and expose it to the upload process as ARGOS_TOKEN. Avoid printing the token in logs.
  5. Check build metadata: Argos reads commit, branch, and pull-request information from CI environment variables. Confirm your CI provider makes the expected metadata available to the job.

Upload a directory with the Argos CLI

Use a separate CLI step when your test framework already saves screenshots to disk and you want to upload them after capture. Adapt the command and path to your project:

npx @argos-ci/cli upload ./screenshots

Example GitHub Actions job shape

This example shows the order of operations. The dependency installation, script name, directory, and secret interpolation are illustrative; adjust them for your repository and workflow.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Sale
GMKtec G3S Mini PC Intel N95 Processor (Up to 3.4GHz) 8GB RAM 256GB M.2 SSD
  • 12th Intel Alder Lake N95 Processor – The GMKtec G3 S Mini PC is powered by the 12th Gen Intel N95 processor with 4 cores, 4 threads, 6MB cache and a burst frequency up to 3.4GHz. Compared with N100/N5105/N5100/N5095, the N95 delivers up to 36% overall performance improvement. Perfect for routine tasks, office work, and home entertainment, this compact mini desktop is more convenient than traditional bulky PCs.
  • 8GB RAM & 256GB SSD Storage – Pre-installed with 8GB DDR4 memory and a fast 256GB M.2 2242 SSD, the G3 S mini desktop offers quicker startup, smoother multitasking, and faster file transfers. Enjoy seamless performance whether you’re working on multiple applications, browsing, or streaming content.
  • Rich Interfaces & Connectivity – The G3 S mini computer comes equipped with USB 3.2 (up to 10Gbps), dual HDMI 2.0 (4K@60Hz), and a 3.5mm audio jack. With support for WiFi 5, Bluetooth 5.0, and Gigabit Ethernet (RJ45 1000MbE), it connects easily with monitors, projectors, printers, office equipment, and other peripherals, making it versatile for both home and business use.
  • Dual 4K Display Support – Featuring upgraded Intel UHD Graphics (up to 1000MHz), the G3 S supports 4K video playback and AV1 decoding for a smooth viewing experience. With dual HDMI outputs, you can connect two 4K@60Hz displays simultaneously, enabling efficient multitasking for work and entertainment.
  • GMKtec WARRANTY - GMKtec offers a 1-year limited GMKtec's warranty for each mini PC, starting from the date of the purchase. All defects due to design and workmanship are covered. With a professional after sales team always ready to attend to your needs, you can simply relax and enjoy your mini PC.
steps:
  - name: Install dependencies
    run: npm ci
  - name: Capture screenshots
    run: npm run test:visual
  - name: Upload screenshots to Argos
    run: npx @argos-ci/cli upload ./screenshots
    env:
      ARGOS_TOKEN: ${{ secrets.ARGOS_TOKEN }}

For a non-GitHub self-hosted CI provider, use that provider’s own secret syntax to set ARGOS_TOKEN. The CLI upload pattern is general, but authentication and CI metadata configuration can vary across providers.

Choose CLI, Node SDK, or Playwright integration

CLI

Choose the CLI when a framework or script has already created screenshot files and a command-line upload step fits your pipeline. It is the framework-independent file-upload route.

Node.js SDK

Use the Node SDK when upload should happen inside a Node process or when you need to set the screenshot root and file patterns programmatically. The SDK example imports upload from @argos-ci/core, passes root and files, and uses ARGOS_TOKEN by default when no token is supplied.

Rank #2
Sale
BOSGAME E5 11 Pro Mini PC, AMD Ryzen 5300U 4C/ 8T, Business Home Office PC
  • 【AMD Ryzen 3 5300U CPU: Outperforms N150 & 3500U】 BOSGAME E5 mini PC is powered by the TSMC 7nm FinFET architecture AMD Ryzen 3 5300U processor (4 Cores, 8 Threads, up to 3.8GHz boost, 6MB total cache). Compared to low-end Intel N150 or 3500U chips which only have 4 single threads and throttle under load, the 5300U delivers over 30% faster multi-core speed. Run 30+ browser tabs, large Excel sheets, and Zoom meetings simultaneously without system lag.
  • 【8GB DDR4 RAM & 256GB NVMe SSD Storage】 Installed with high-speed 8GB DDR4 dual-channel memory and a fast 256GB M.2 2280 SSD, eliminating slow boot times and application loading delays. To accommodate growing data requirements, the upgradeable hardware design features dual SODIMM slots that allow you to expand memory up to 64GB RAM, ensuring smooth operation during heavy multitasking.
  • 【High-Capacity Dual M.2 SSD Storage Expansion】 Never worry about running out of space for your business files. In addition to the pre-installed 256GB system drive, the motherboard houses an extra empty internal M.2 2280 NVMe PCIe 3.0 slot. This allows you to easily add a second solid-state drive for up to an additional 2TB of storage capacity (upgrades not included) without needing to remove or reinstall the original operating system.
  • 【Radeon 6-Core Graphics & Triple 4K Displays】 Integrated with official AMD Radeon Graphics (6 Graphics Cores, 1500 MHz frequency) for casual gaming, photo editing, and crisp 4K media decoding. Featuring 1x HDMI 2.0 port, 1x DisplayPort, and 1x Full-Function Type-C port, the E5 outputs true 4K@60Hz resolution to three monitors at once. This multi-screen setup eliminates constant window-switching for traders, programmers, and office workers.
  • 【Dual 2.5GbE LAN Ports for Advanced Networking】 Experience fast wired network transmission speeds up to 2500Mbps without lagging or buffering. The integration of dual 2.5 Gigabit Ethernet ports (powered by Realtek RTL8125 controller) makes this compact computer an exceptional hardware choice for tech enthusiasts. Easily configure it into software routers, hardware firewalls (pfSense, OpnSense), home NAS servers, or local homelabs.
import { upload } from "@argos-ci/core";

await upload({
  root: "./screenshots",
  files: ["**/*.png"],
});

Adjust the glob for the formats and directory your capture process produces. The SDK reference states: “Defaults to the ARGOS_TOKEN environment variable.” See the Argos SDK reference for the current API and configuration details.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Playwright reporter or helper

If your capture flow runs in Playwright, Argos also documents a reporter integration and an argosScreenshot helper. A reporter can upload during a test run; the CLI remains useful when files come from another framework or when you want a distinct upload step. Review the Argos Playwright documentation to choose the integration that matches your test setup.

GitHub Actions authentication: token or OIDC

For generic runner setups, use a protected Argos project token as ARGOS_TOKEN. GitHub Actions has an additional documented option: Argos’s changelog dated May 11, 2026 describes OIDC authentication instead of a reusable Argos token. To use it, enable OIDC in Argos Project Settings and grant the workflow id-token: write; the documented setup removes ARGOS_TOKEN from the job.

Rank #3
Beelink SER5 MAX Mini Pc,AMD Ryzen 7 7735U (8C/16T,up to 4.75GHz),Mini Computer with 24GB LPDDR5 RAM/500GB M.2 2280 SSD,Micro Pc Support 4K FPS,WiFi6/BT5.4/2.5G LAN/Home/Office
  • 【MAX 7735U High Performance 】Powered by the AMD Ryzen 7 7735U (8-Core, 16-Thread, boost up to 4.75GHz), this Beelink SER5 MAX mini PC delivers robust performance for daily office tasks, including spreadsheet editing, PPT creation, email management, coding and web browsing. It effortlessly handles photo and video editing via PS, PR and Lightroom, and runs popular esports titles such as LoL, CSGO and DOTA 2 at excellent settings.
  • 【High‑Speed Memory & Storage】 Equipped with 24GB high-speed LPDDR5 RAM and a blazing-fast 500GB M.2 2280 PCIe 4.0 SSD, this BEELINK 7735U MINI PC supports seamless heavy multitasking. It features expandable storage up to 8TB, letting you store massive project archives and local files without worry.
  • 【4K Triple Display & Radeon 680M Graphics】 Built-in AMD Radeon 680M Graphics (12-Core, 2200MHz) brings outstanding graphic performance for design work and buttery-smooth 4K HDR video playback. This BEELINK SER5 MINI PC supports triple 4K monitors via HDMI, DP and USB-C port, allowing you to run trading dashboards, spreadsheets and design drafts side-by-side to boost your productivity.
  • 【Cooling & Full Connectivity】 This BEELINK SER5 7735U MINI PC adopts an upgraded dual‑cooling system with heatsink and cooling fan that boosts heat dissipation by 19% while keeping noise below 32dB for quiet operation. Equipped with WiFi 6, Bluetooth 5.4 and 2.5G RJ45 Ethernet port, it delivers stable, lag‑free connections ideal for office work, home media and home‑server use.
  • 【Lifetime Technical Support】Ryzen 7 mini pc Package Included:1* Beelink Ser5 7735U Mini PC,1* HDMI Cables( 100cm),1* Power adapter,1* User manual,1* Mounting bracket.If you want to set up automatic startup,please contact us.All of our mini pc obtained FCC,CE ROSH Certifications.We Offer 1 Year Free Warranty,and 7 Days/24 Hours Serving,and lifetime technical issue assistance without worrying about quality,just email to our customer service team.

The same announcement describes tokenless fallback behavior when GitHub does not issue OIDC tokens, especially for fork pull requests and public repositories, after Argos verifies the workflow run with GitHub. This is a GitHub-specific flow and should not be assumed to apply to other self-hosted CI providers. See the Argos changelog entry for its setup details.

Keep visual comparisons reproducible

Screenshot output can vary with the operating system and browser environment. When consistent comparisons matter, keep the runner image, browser version and setup, fonts, and relevant dependencies stable. Argos notes that rendering is platform-dependent; consistency in the capture environment helps reduce noise in diffs. See the Argos FAQ for its guidance on rendering differences.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Troubleshoot common upload problems

Symptom Likely cause What to check
No images appear in Argos The capture step did not run, produced no files, or saved them somewhere other than the CLI target. Check the capture step’s result and confirm the directory passed to argos upload matches its output path.
Authentication fails ARGOS_TOKEN is unset, incorrect, or unavailable to the upload process; alternatively, the provider-specific authentication setup is incomplete. Check the protected secret mapping without echoing the token. For GitHub OIDC, verify the Argos project setting and id-token: write permission.
The build is associated with the wrong change or has missing metadata The CI environment did not expose the expected commit, branch, or pull-request variables. Inspect the metadata available to the upload job and verify your CI provider’s integration with Argos.
Diffs are noisy or inconsistent Capture conditions vary across operating systems, browsers, fonts, or dependencies. Stabilize the runner image and browser setup where possible, then compare captures made under the same conditions.
You are unsure whether to use a framework integration The upload and capture responsibilities are being conflated. Use the CLI for files generated independently; consider the documented Playwright reporter or helper when capture happens in Playwright.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

If your goal is to fetch a website screenshot rather than upload screenshots produced by your own test suite, ScreenshotNeo is a website screenshot API and MCP server. One GET request returns an image or PDF; it is a different workflow from Argos’s visual-test upload.

Rank #4
GMKtec Mini PC Computer, G10 Ryzen 5 3500U (Beats N150/4300U/3200U), 16GB RAM 512GB SSD 2.5GbE NIC LAN Desktop Office Home Business HTPC, Triple 4K Display, WiFi, BT, USB-C, DP, Type-C PD, HDMI 2.1
  • MINI PC COMPUTER OFFICE LIGHT GAMING - GMKtec Nucbox G10 Series is equipped with the Ryzen 5 3500U, a 64-bit quad-core mid-range performance x86 mobile microprocessor. This processor is based on AMD's Zen+ microarchitecture and is fabricated on a 12 nm process. The 3500U operates at a base frequency of 2.1 GHz with a TDP of 15 W and a Boost frequency of 3.7 GHz. This APU supports up to 32 GB of dual-channel DDR4-2400 memory and incorporates Radeon Vega 8 Graphics operating at up to 1.2 GHz. 20% Multi-core Performance increase over previous Ryzen 3 models such as 4300U. 35% performance increase over the Intel N-series N95/N97/N150.
  • RYZEN 5 3500U vs RYZEN 3 4300U COMPARISON - Why Choose Ryzen 5 3500U: Better multi-threaded performance: More threads, better suited for multitasking and demanding applications. Better graphics: With Vega 8, it's superior for casual gaming, video playback, and GPU-intensive tasks. Overall higher performance: Higher boost clock and better ability to handle a variety of workloads, from light gaming to productivity tasks. So, if you're looking for a more balanced processor with stronger multitasking capabilities and better GPU performance, the Ryzen 5 3500U would be the clear choice.
  • 16GB DUAL CHANNEL DDR4 + 512GB SSD - Installed with DDR4 16GB SO-DIMM RAM Dual Channel (2x8GB) and a 512GB SSD, the Nucbox G10 mini pc supports memory expansion to 64GB RAM. Featured with Dual M.2 2280 PCIe 3.0 slots, supports dual storage slot expansion to 16TB SSD (2*8TB). (Upgrades not included) This model supports a configurable TDP-down of 12 W and TDP-up of 35 W.
  • UNLEASH RAW PERFORMANCE MODE 25W - Dominate demanding tasks with the AMD Ryzen 5 3500U processor. When switched to Performance Mode in the BIOS (press "Esc" key repeatedly during boot, save then exit), this mini PC delivers superior multi-core processing power, significantly outperforming Intel N-series chips in CPU-intensive applications, multitasking, and creative workloads.
  • MINI DESKTOP COMPUTER WITH TRIPLE DISPLAY SCREEN - Nucbox G10 integrates AMD Radeon Vega 8 1200 MHz GPU to deliver powerful graphics processing power to easily handle video editing, and playback, or casual gaming. And it can connect to 3 display screens simultaneously via HDMI 2.1 TMDS/ DPv1.4/ TYPE-C.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

See the ScreenshotNeo API documentation for request options. It can remove cookie and consent banners, newsletter popups, and chat widgets before capture; bot checks, blank pages, and failed loads are not billed. Its MCP server lets AI agents take screenshots, and the free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000.

Sign up for ScreenshotNeo’s free plan.

Frequently Asked Questions

Does Argos capture screenshots when I run the upload command?

No. The capture workflow must create screenshot files before the CLI or SDK upload step runs.

Can I use Argos CLI uploads from a self-hosted CI provider other than GitHub Actions?

The general CLI directory-upload pattern is not limited to GitHub Actions, but token handling, secret syntax, and CI metadata depend on the provider.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Can Argos upload screenshots created by a framework other than Playwright?

The CLI is documented as a general upload route for screenshots produced by different frameworks, provided they create files Argos can accept.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.