# SigmanticAI

**AI-powered hardware verification from the command line.**

SigmanticAI generates complete chip verification environments — UVM testbenches, SystemVerilog assertions, coverage models, and RTL — from natural language descriptions. All heavy computation (compilation, simulation, LLM inference) runs in the cloud; the CLI is a lightweight client.

## Installation

```bash
pip install sigmanticai
```

Requires Python 3.10+.

## Quick Start

```bash
# Sign in (opens browser)
sigmanticai login

# Interactive mode — chat with the AI agent
sigmanticai

# One-shot generation
sigmanticai generate "Build a UVM testbench for a 32-bit AXI4 FIFO"

# Check your account
sigmanticai whoami
sigmanticai status
```

## What It Does

- **Generate verification environments** — UVM testbenches, scoreboards, coverage, and assertions from a single prompt
- **Design RTL modules** — counters, FIFOs, arbiters, interfaces, and more
- **Edit existing code** — point the agent at your codebase and ask for changes
- **Run compilation & simulation** — Verilator, Questa, and other EDA tools run server-side (no local install needed)
- **Iterative debugging** — the agent automatically fixes compilation errors and re-runs until tests pass

## How It Works

1. You type a prompt in the CLI
2. Your project files are synced to a cloud worker
3. The AI agent generates, compiles, and simulates — all server-side
4. Generated files are streamed back to your local directory
5. You edit locally; changes sync automatically on your next message

No EDA tools required on your machine. No GPU needed. Just `pip install` and go.

## Commands

| Command | Description |
|---------|-------------|
| `sigmanticai` | Interactive REPL (main mode) |
| `sigmanticai login` | Sign in via browser |
| `sigmanticai login --email <e> --password <p>` | Headless login (CI/scripts) |
| `sigmanticai logout` | Clear stored credentials |
| `sigmanticai whoami` | Show current user |
| `sigmanticai status` | Show plan, quota, account info |
| `sigmanticai jobs` | List recent generation jobs |
| `sigmanticai generate "<prompt>"` | One-shot generation |

## Interactive Commands

Inside the REPL:

| Command | Description |
|---------|-------------|
| `/upload <path>` | Push a specific file or directory to the server |
| `/help` | Show available commands |
| `exit` / `quit` / `q` | End session |

## Requirements

- Python 3.10+
- Internet connection (all computation runs in the cloud)
- A SigmanticAI account — sign up at [sigmanticai.com](https://sigmanticai.com)

## Links

- **Website:** [sigmanticai.com](https://sigmanticai.com)
- **Documentation:** [docs.sigmanticai.com](https://docs.sigmanticai.com)
- **Issues:** [github.com/sigmanticai/sigmanticai-cli/issues](https://github.com/sigmanticai/sigmanticai-cli/issues)
