# Sue2 V7 — internal test install (Apple Silicon Mac)

Sue2 V7 is a native macOS rewrite of the Sue2 schematic editor with the
CppSim/VppSim/NGspice simulation toolchain, waveform viewers, and an AI
assistant interface, packaged as one self-contained wheel.

## Install (about 2 minutes)

1. Unzip this bundle anywhere.
2. Open Terminal in the unzipped folder and run:

   ```
   ./install.sh
   ```

   That installs `uv` (a standard Python tool manager, if you don't have
   it), installs Sue2 V7 into its own isolated environment (your system
   Python is untouched), and creates **Sue2** in `~/Applications`.

3. Launch **Sue2** from `~/Applications` (drag it to your Dock if you
   like) or run `sue2` in a terminal. The first launch creates `~/CppSim`
   with example libraries and settings.

No admin password, no Gatekeeper overrides, and no code-signing dialogs
are expected — everything installs into your home directory.

## Trying it out

- **File ▸ Open** shows the example libraries (PLL synthesizers,
  delta-sigma converters, CDR, SPICE examples...).
- Open `sd_synth_fast`, press the **CppSim** button, then **Compile/Run**,
  then **AnaWave** to plot signals.
- **Help ▸ Documentation** has the manuals, including the AI Integration
  Manual if you want an AI assistant (e.g. Claude Code) to drive Sue2 —
  point it at `~/CppSim/AI` per that manual.

## Uninstall

```
sue2 --remove-launcher
uv tool uninstall sue2
rm -rf ~/CppSim        # only if you also want your design data gone
```

## License

MIT, Copyright (c) 2002-2026 Michael H. Perrott — provided AS IS, with no
warranty of any kind and no commitment to support, maintenance, updates,
or fixes (net2code ships as a prebuilt binary only; third-party terms in
the bundled NOTICE/LICENSES).

## Feedback

Anything surprising — installation friction, crashes, confusing behavior,
missing features — please note the exact steps and send them back. This
internal round exists to find issues before a public release.
