# Hydra — card for AI agents

Live-coding video synth in the browser: chain oscillators, noise, feedback and camera inputs into abstract motion visuals.

Category: Video references and motion backgrounds (also: Web animation examples and effects) · maker Olivia Jack and contributors · checked 2026-11-05 · style: abstract, retro, colorful, dark

## Price
- Price: Free
- Free tier: Fully free.

## License
AGPL-3.0 — https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE

- commercial: **conditions** (Commercial use with conditions)
  > You may charge any price or no price for each copy that you convey,
  (https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE)
- attribution: **no** (No credit needed)
  > You may convey verbatim copies of the Program's source code as you
  (https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE)
- in app: **conditions** (Ship inside your app with conditions)
  > The GNU Affero General Public License is designed specifically to
  (https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE)
- redistribute: **conditions** (Pass the files on to your users only with conditions)
  > You may convey verbatim copies of the Program's source code as you
  (https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE)

## Rules to follow
- Embedding hydra-synth in a site/app brings AGPL-3.0 source-sharing obligations.
- Recorded video output is your own work; the license covers the software.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How an agent gets files
- Use the editor at hydra.ojack.xyz to sketch and screen-record a loop, or npm install hydra-synth and run a sketch on a canvas. (sign-in: none)
- Formats: js, webm
- Not allowed: AGPL-3.0

## How to connect
- Package (npm/PyPI)
- npm: `npm install hydra-synth`
- Repository: https://github.com/hydra-synth/hydra
- Website: https://hydra.ojack.xyz

## Notes
The license text does not address recorded output; the 'output is yours' rule is our reading of copyleft software licenses, not a quote.

## Numbers (AgentGid data)
- Gid Score: 25
- GitHub stars: 2,753
- Downloads last week: 4,637

## Lines to paste into your prompt or AGENTS.md

```
- Hydra (Video references and motion backgrounds, Web animation examples and effects). Live-coding video synth in the browser: chain oscillators, noise, feedback and camera inputs into abstract motion visuals. Price: free; commercial use with conditions; no credit needed; ship inside your app with conditions; pass the files on to your users only with conditions. Style: abstract, retro, colorful, dark.
  Connect: npm hydra-synth.
  Get files: Use the editor at hydra.ojack.xyz to sketch and screen-record a loop, or npm install hydra-synth and run a sketch on a canvas (js, webm).
  Not allowed: AGPL-3.0
  Rule: Embedding hydra-synth in a site/app brings AGPL-3.0 source-sharing obligations.
  Rule: Recorded video output is your own work; the license covers the software.
  License: https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE (checked 2026-11-05; details: https://agentgid.com/assets/hydra/)
```

## Links
- AgentGid page: https://agentgid.com/assets/hydra/
- Is it free for commercial use? https://agentgid.com/assets/hydra/commercial-use/
- Source: https://hydra.ojack.xyz/
- Source: https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE
- Source: https://registry.npmjs.org/hydra-synth/latest


## Hydra: live-coded moving visuals in the browser

Hydra is a free video synthesizer that runs in a web browser. You type short lines of code and get moving color patterns, which you can mix with a camera, a video or sound. Use it in its online editor, or put its engine on your own page as a moving background.

### Where to use it
- Moving background for a page: Put a slowly moving color pattern behind the headline of a landing page or event page, drawn live in the visitor's browser instead of a heavy video file.
- Visuals for a live show: Make visuals for a concert, DJ set or club night that react to the music and change as you type during the show.
- Effects on a camera picture: Turn a webcam or a shared screen into a mirror pattern or a glitchy picture, for a stream, a video call backdrop or an art installation.
- A short video loop to download: Record a few seconds of a pattern as a video file and use it as a background clip in a video, a slide or a social post.
- Learning how video effects work: Try out feedback, fractals and pixel tricks step by step in the free online editor, with no install.
- A playful poster for an event: Give a club night or a meetup page an animated top banner that matches the printed poster colors. (idea, not from the official pages)

### How to start
- Open the online editor at hydra.ojack.xyz, type a line such as osc(20, 0.1, 0.8).out() and run it with Ctrl+Enter.

```
osc(20, 0.1, 0.8).out()
```

- To use it on your own page, add the hydra-synth package (or its bundled script file) and start it on a canvas.

```
import Hydra from 'hydra-synth'
const hydra = new Hydra({ detectAudio: false })
osc(4, 0.1, 1.2).out()
```


### License
Hydra's code is under AGPL-3.0, a strong share-alike license. Running it and using the pictures or videos it makes is fine, even in paid work. If you ship Hydra's code inside your own site or app, you must keep its license and offer the source.

### Good to know
- If you change Hydra's engine and run it on a public site, you must let every visitor get the source of your changed version.
- The project calls itself experimental, and its main readme says it works best in Chrome on computers with graphics support, so test other browsers before you rely on it.
- By default the engine listens to the microphone, so the browser asks visitors for it. Turn sound input off unless you need it.
- Sketches you upload from the online editor go to the public Hydra gallery, so do not put private text or links in them.
- The built-in recorder is easy but the docs warn its videos can look rough; most users record the window with OBS instead.

Checked 2026-11-12 against: https://hydra.ojack.xyz/, https://hydra.ojack.xyz/docs/, https://hydra.ojack.xyz/docs/docs/quick-start/, https://hydra.ojack.xyz/docs/docs/learning/getting-started/, https://hydra.ojack.xyz/docs/docs/learning/web-editor/, https://hydra.ojack.xyz/docs/docs/learning/interactivity/audio/, https://hydra.ojack.xyz/docs/docs/learning/guides/how-to/hydra-in-a-webpage/, https://hydra.ojack.xyz/docs/docs/learning/guides/how-to/record-hydra-output/, https://hydra.ojack.xyz/docs/docs/learning/guides/how-to/use-hydra-without-showing-code/, https://github.com/hydra-synth/hydra/blob/main/README.md, https://raw.githubusercontent.com/hydra-synth/hydra/main/LICENSE, https://github.com/hydra-synth/hydra-synth/blob/main/README.md, https://github.com/hydra-synth/hydra-synth/blob/main/LICENSE, https://registry.npmjs.org/hydra-synth/latest, https://registry.npmjs.org/hydra-synth/1.4.0

### Mistakes to avoid
- Don't: <script src="https://cdn.jsdelivr.net/npm/hydra-synth/dist/hydra-synth.js"> as in the how-to page → Do: Pin the version (hydra-synth@1.4.0) or serve the file yourself (The link without a version always takes the newest release, which can change the page without warning.)
- Don't: new Hydra() with the default options on a public page → Do: new Hydra({ detectAudio: false }) unless the sketch reacts to sound (The default turns on sound input, which makes the browser ask every visitor for the microphone.)
- Don't: Calling osc(), noise() and o0 as globals inside an app that has its own code → Do: new Hydra({ makeGlobal: false }).synth, then h.osc(), h.noise(), h.o1 (The default mode adds Hydra's functions to the whole page; in non-global mode everything starts from the instance.)
- Don't: Importing hydra-synth in a Vite project with no extra setting → Do: Add define: { global: {} } to the Vite config, or a polyfill for global (A package Hydra uses expects the Node global, and Vite pages stop with an error.)
- Don't: Copying a changed hydra-synth into a closed-source app → Do: Keep the AGPL-3.0 license with the code and offer the source of your version, or pick a permissive library (AGPL-3.0 asks for the source of modified versions that people use over a network.)

### Questions
- Can I use a video I recorded from Hydra in a paid ad or on YouTube? The license covers Hydra's code, and output is covered only if the output itself is a covered work, so a recorded pattern is your own clip.
- Can I put Hydra on my company website? Yes, but the engine is AGPL-3.0, so keep its license with the code you ship and offer the source of any changed version to visitors.
- How do I save a still picture? Press Ctrl+Shift+S in the editor, or call screencap(); it saves the picture and the code that made it.
- Can I show the visuals without the code on top? Yes. Press Ctrl+Shift+H in the editor to hide the code, or add showCode=false to a shared sketch link.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
