exactor-cli 1.28.1__tar.gz → 1.29.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,143 @@
1
+ Metadata-Version: 2.4
2
+ Name: exactor-cli
3
+ Version: 1.29.0
4
+ Summary: Exactor CLI & Python SDK — XOR-native Boolean minimization for ZK/FHE/MPC and EDA (https://exactor.tech)
5
+ Author: Exactor Research
6
+ License: Proprietary
7
+ Project-URL: Homepage, https://exactor.tech
8
+ Project-URL: Documentation, https://exactor.tech/GETTING_STARTED.md
9
+ Project-URL: API, https://exactor.tech/public-swagger-ui
10
+ Keywords: boolean,logic-minimization,xor,esop,synthesis,zk,fhe,mpc,blif,aiger,eda,verilog,fsm
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Science/Research
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
16
+ Requires-Python: >=3.8
17
+ Description-Content-Type: text/markdown
18
+
19
+ # exactor-cli
20
+
21
+ **Boolean logic minimization for the real world — XOR-native, verifiable, one command.**
22
+
23
+ `exactor-cli` is the official Python client for the [Exactor Cloud Engine](https://exactor.tech): the only optimizer that returns the **minimal Boolean function itself** in canonical ESOP/XOR form — not just a smaller circuit. Built for the workloads where structure matters: **ZK proofs, FHE, MPC, ACL/rule matrices, and hardware flows**.
24
+
25
+ ```bash
26
+ pip install exactor-cli
27
+ ```
28
+
29
+ ---
30
+
31
+ ## Why Exactor
32
+
33
+ | | Typical EDA tools | **Exactor** |
34
+ |---|---|---|
35
+ | Output | A circuit (AIG/XAG netlist) | **The minimal Boolean function** (canonical ESOP, XOR factors intact) |
36
+ | Native formats | BLIF/AIGER | BLIF · AIGER `.aag` · bench · PLA · `exactor-netlist-v1` — **in and out** |
37
+ | ZK/FHE/MPC | bolt-on scripts | **first-class emitters**: Bristol, Circom, testbench + certificate |
38
+ | Sequential | full flows | FSM state minimization + reachability (`fsm_minimize`, `fsm_init`) |
39
+ | Verification | separate tool | per-result verification + formal equivalence via Yosys plugin |
40
+ | Price | free but DIY | **light jobs free (0 SU)** — pay only for heavy synthesis |
41
+
42
+ Works wherever Python 3.8+ runs — stdlib only, zero dependencies.
43
+
44
+ ---
45
+
46
+ ## Quickstart — first simplification in 2 minutes
47
+
48
+ ```bash
49
+ # 1. Get a free API key at https://exactor.tech (Console → API Keys)
50
+
51
+ # 2. Login
52
+ exactor login --token ek_YOUR_KEY
53
+
54
+ # 3. Minimize
55
+ exactor minimize circuit.pla -o out.v
56
+ ```
57
+
58
+ ```
59
+ EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
60
+ Solver Latency: 16 ms
61
+ Result Equation: !(c ^ b) & !a + (d ^ c) & !a
62
+ ```
63
+
64
+ No install at all? The API is plain HTTPS:
65
+
66
+ ```bash
67
+ curl -X POST https://exactor.tech/api/simplify \
68
+ -H "Authorization: Bearer ek_YOUR_KEY" \
69
+ -H "Content-Type: application/json" \
70
+ -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
71
+ ```
72
+
73
+ ---
74
+
75
+ ## As a library
76
+
77
+ ```python
78
+ from exactor import ExactorClient, ExactorError
79
+
80
+ client = ExactorClient(token="ek_...") # or EXACTOR_TOKEN env
81
+
82
+ # Boolean function by minterms
83
+ res = client.simplify(variables=["a","b","c","d"],
84
+ minterms=[0,1,2,5,6,7],
85
+ emit=["verilog","metrics"])
86
+ print(res["result"], res["su_used"])
87
+
88
+ # Structural netlist — accepts BLIF, .aag, .bench or exactor-netlist-v1 JSON
89
+ res = client.simplify_netlist(open("circuit.blif").read(),
90
+ fsm_minimize=True, fsm_init="0")
91
+
92
+ # Free dry-run analysis (0 SU)
93
+ print(client.analyze(["a","b","c"], [0,1,5,7]))
94
+ ```
95
+
96
+ `ExactorError` exposes `.status`, `.is_quota` (402), `.is_rate_limited` (429).
97
+
98
+ ---
99
+
100
+ ## What you can throw at it
101
+
102
+ - **`.pla`** — Espresso standard
103
+ - **`.json`** — `{variables, minterms, dont_cares}`
104
+ - **`.blif`** — ABC/Yosys `write_blif` output, straight in
105
+ - **`.aag`** — ASCII AIGER (Simplifier/SAT-sweeping tools)
106
+ - **`.bench`** — ISCAS bench (Simplifier native)
107
+ - **`exactor-netlist-v1`** — structural DAG from the `yosys-exactor` plugin, including sequential flop/latch cuts
108
+
109
+ Outputs: Verilog, VHDL, BLIF, xespresso ESOP, **Bristol** (ZK), **Circom** (ZK), self-checking **testbench** + equivalence certificate, Yosys script.
110
+
111
+ ---
112
+
113
+ ## CLI reference
114
+
115
+ ```bash
116
+ exactor login --token ek_... # store credentials
117
+ exactor whoami / balance # plan + SU balance
118
+ exactor minimize in.pla -o out.v # sync simplify (.pla/.json/.blif/.aag/.bench)
119
+ exactor minimize big.pla --async --wait # distributed job for large inputs
120
+ exactor minimize net.json --fsm-minimize --fsm-init 0
121
+ exactor status <job_id> # async job polling
122
+ ```
123
+
124
+ Engine knobs: `--max-sim-vars`, `--esop-budget`, `--no-fhe-cost-aware`, `--simplifier-prepass` / `--no-simplifier-prepass`, `--blind` (π/σ anonymized submission).
125
+
126
+ ---
127
+
128
+ ## Billing — light jobs are free
129
+
130
+ Jobs within the FREE envelope (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates) cost **0 SU on every plan** — rate-limited, not metered. SU are only consumed by heavy synthesis (33–128 vars, large netlists, FSM minimization at scale). See [credits-and-billing](https://exactor.tech) for the full model.
131
+
132
+ ---
133
+
134
+ ## Links
135
+
136
+ - **Service & console:** https://exactor.tech
137
+ - **Interactive API docs:** https://exactor.tech/public-swagger-ui
138
+ - **Getting started guide:** https://exactor.tech/GETTING_STARTED.md
139
+ - **Yosys plugin:** `yosys-exactor` (`exactor_netlist`, `exactor_spec`, `exactor_import`)
140
+
141
+ ---
142
+
143
+ *Proprietary client for the Exactor Cloud Engine. Python 3.8+, stdlib only.*
@@ -0,0 +1,125 @@
1
+ # exactor-cli
2
+
3
+ **Boolean logic minimization for the real world — XOR-native, verifiable, one command.**
4
+
5
+ `exactor-cli` is the official Python client for the [Exactor Cloud Engine](https://exactor.tech): the only optimizer that returns the **minimal Boolean function itself** in canonical ESOP/XOR form — not just a smaller circuit. Built for the workloads where structure matters: **ZK proofs, FHE, MPC, ACL/rule matrices, and hardware flows**.
6
+
7
+ ```bash
8
+ pip install exactor-cli
9
+ ```
10
+
11
+ ---
12
+
13
+ ## Why Exactor
14
+
15
+ | | Typical EDA tools | **Exactor** |
16
+ |---|---|---|
17
+ | Output | A circuit (AIG/XAG netlist) | **The minimal Boolean function** (canonical ESOP, XOR factors intact) |
18
+ | Native formats | BLIF/AIGER | BLIF · AIGER `.aag` · bench · PLA · `exactor-netlist-v1` — **in and out** |
19
+ | ZK/FHE/MPC | bolt-on scripts | **first-class emitters**: Bristol, Circom, testbench + certificate |
20
+ | Sequential | full flows | FSM state minimization + reachability (`fsm_minimize`, `fsm_init`) |
21
+ | Verification | separate tool | per-result verification + formal equivalence via Yosys plugin |
22
+ | Price | free but DIY | **light jobs free (0 SU)** — pay only for heavy synthesis |
23
+
24
+ Works wherever Python 3.8+ runs — stdlib only, zero dependencies.
25
+
26
+ ---
27
+
28
+ ## Quickstart — first simplification in 2 minutes
29
+
30
+ ```bash
31
+ # 1. Get a free API key at https://exactor.tech (Console → API Keys)
32
+
33
+ # 2. Login
34
+ exactor login --token ek_YOUR_KEY
35
+
36
+ # 3. Minimize
37
+ exactor minimize circuit.pla -o out.v
38
+ ```
39
+
40
+ ```
41
+ EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
42
+ Solver Latency: 16 ms
43
+ Result Equation: !(c ^ b) & !a + (d ^ c) & !a
44
+ ```
45
+
46
+ No install at all? The API is plain HTTPS:
47
+
48
+ ```bash
49
+ curl -X POST https://exactor.tech/api/simplify \
50
+ -H "Authorization: Bearer ek_YOUR_KEY" \
51
+ -H "Content-Type: application/json" \
52
+ -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
53
+ ```
54
+
55
+ ---
56
+
57
+ ## As a library
58
+
59
+ ```python
60
+ from exactor import ExactorClient, ExactorError
61
+
62
+ client = ExactorClient(token="ek_...") # or EXACTOR_TOKEN env
63
+
64
+ # Boolean function by minterms
65
+ res = client.simplify(variables=["a","b","c","d"],
66
+ minterms=[0,1,2,5,6,7],
67
+ emit=["verilog","metrics"])
68
+ print(res["result"], res["su_used"])
69
+
70
+ # Structural netlist — accepts BLIF, .aag, .bench or exactor-netlist-v1 JSON
71
+ res = client.simplify_netlist(open("circuit.blif").read(),
72
+ fsm_minimize=True, fsm_init="0")
73
+
74
+ # Free dry-run analysis (0 SU)
75
+ print(client.analyze(["a","b","c"], [0,1,5,7]))
76
+ ```
77
+
78
+ `ExactorError` exposes `.status`, `.is_quota` (402), `.is_rate_limited` (429).
79
+
80
+ ---
81
+
82
+ ## What you can throw at it
83
+
84
+ - **`.pla`** — Espresso standard
85
+ - **`.json`** — `{variables, minterms, dont_cares}`
86
+ - **`.blif`** — ABC/Yosys `write_blif` output, straight in
87
+ - **`.aag`** — ASCII AIGER (Simplifier/SAT-sweeping tools)
88
+ - **`.bench`** — ISCAS bench (Simplifier native)
89
+ - **`exactor-netlist-v1`** — structural DAG from the `yosys-exactor` plugin, including sequential flop/latch cuts
90
+
91
+ Outputs: Verilog, VHDL, BLIF, xespresso ESOP, **Bristol** (ZK), **Circom** (ZK), self-checking **testbench** + equivalence certificate, Yosys script.
92
+
93
+ ---
94
+
95
+ ## CLI reference
96
+
97
+ ```bash
98
+ exactor login --token ek_... # store credentials
99
+ exactor whoami / balance # plan + SU balance
100
+ exactor minimize in.pla -o out.v # sync simplify (.pla/.json/.blif/.aag/.bench)
101
+ exactor minimize big.pla --async --wait # distributed job for large inputs
102
+ exactor minimize net.json --fsm-minimize --fsm-init 0
103
+ exactor status <job_id> # async job polling
104
+ ```
105
+
106
+ Engine knobs: `--max-sim-vars`, `--esop-budget`, `--no-fhe-cost-aware`, `--simplifier-prepass` / `--no-simplifier-prepass`, `--blind` (π/σ anonymized submission).
107
+
108
+ ---
109
+
110
+ ## Billing — light jobs are free
111
+
112
+ Jobs within the FREE envelope (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates) cost **0 SU on every plan** — rate-limited, not metered. SU are only consumed by heavy synthesis (33–128 vars, large netlists, FSM minimization at scale). See [credits-and-billing](https://exactor.tech) for the full model.
113
+
114
+ ---
115
+
116
+ ## Links
117
+
118
+ - **Service & console:** https://exactor.tech
119
+ - **Interactive API docs:** https://exactor.tech/public-swagger-ui
120
+ - **Getting started guide:** https://exactor.tech/GETTING_STARTED.md
121
+ - **Yosys plugin:** `yosys-exactor` (`exactor_netlist`, `exactor_spec`, `exactor_import`)
122
+
123
+ ---
124
+
125
+ *Proprietary client for the Exactor Cloud Engine. Python 3.8+, stdlib only.*
@@ -0,0 +1,143 @@
1
+ Metadata-Version: 2.4
2
+ Name: exactor-cli
3
+ Version: 1.29.0
4
+ Summary: Exactor CLI & Python SDK — XOR-native Boolean minimization for ZK/FHE/MPC and EDA (https://exactor.tech)
5
+ Author: Exactor Research
6
+ License: Proprietary
7
+ Project-URL: Homepage, https://exactor.tech
8
+ Project-URL: Documentation, https://exactor.tech/GETTING_STARTED.md
9
+ Project-URL: API, https://exactor.tech/public-swagger-ui
10
+ Keywords: boolean,logic-minimization,xor,esop,synthesis,zk,fhe,mpc,blif,aiger,eda,verilog,fsm
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Science/Research
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
16
+ Requires-Python: >=3.8
17
+ Description-Content-Type: text/markdown
18
+
19
+ # exactor-cli
20
+
21
+ **Boolean logic minimization for the real world — XOR-native, verifiable, one command.**
22
+
23
+ `exactor-cli` is the official Python client for the [Exactor Cloud Engine](https://exactor.tech): the only optimizer that returns the **minimal Boolean function itself** in canonical ESOP/XOR form — not just a smaller circuit. Built for the workloads where structure matters: **ZK proofs, FHE, MPC, ACL/rule matrices, and hardware flows**.
24
+
25
+ ```bash
26
+ pip install exactor-cli
27
+ ```
28
+
29
+ ---
30
+
31
+ ## Why Exactor
32
+
33
+ | | Typical EDA tools | **Exactor** |
34
+ |---|---|---|
35
+ | Output | A circuit (AIG/XAG netlist) | **The minimal Boolean function** (canonical ESOP, XOR factors intact) |
36
+ | Native formats | BLIF/AIGER | BLIF · AIGER `.aag` · bench · PLA · `exactor-netlist-v1` — **in and out** |
37
+ | ZK/FHE/MPC | bolt-on scripts | **first-class emitters**: Bristol, Circom, testbench + certificate |
38
+ | Sequential | full flows | FSM state minimization + reachability (`fsm_minimize`, `fsm_init`) |
39
+ | Verification | separate tool | per-result verification + formal equivalence via Yosys plugin |
40
+ | Price | free but DIY | **light jobs free (0 SU)** — pay only for heavy synthesis |
41
+
42
+ Works wherever Python 3.8+ runs — stdlib only, zero dependencies.
43
+
44
+ ---
45
+
46
+ ## Quickstart — first simplification in 2 minutes
47
+
48
+ ```bash
49
+ # 1. Get a free API key at https://exactor.tech (Console → API Keys)
50
+
51
+ # 2. Login
52
+ exactor login --token ek_YOUR_KEY
53
+
54
+ # 3. Minimize
55
+ exactor minimize circuit.pla -o out.v
56
+ ```
57
+
58
+ ```
59
+ EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
60
+ Solver Latency: 16 ms
61
+ Result Equation: !(c ^ b) & !a + (d ^ c) & !a
62
+ ```
63
+
64
+ No install at all? The API is plain HTTPS:
65
+
66
+ ```bash
67
+ curl -X POST https://exactor.tech/api/simplify \
68
+ -H "Authorization: Bearer ek_YOUR_KEY" \
69
+ -H "Content-Type: application/json" \
70
+ -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
71
+ ```
72
+
73
+ ---
74
+
75
+ ## As a library
76
+
77
+ ```python
78
+ from exactor import ExactorClient, ExactorError
79
+
80
+ client = ExactorClient(token="ek_...") # or EXACTOR_TOKEN env
81
+
82
+ # Boolean function by minterms
83
+ res = client.simplify(variables=["a","b","c","d"],
84
+ minterms=[0,1,2,5,6,7],
85
+ emit=["verilog","metrics"])
86
+ print(res["result"], res["su_used"])
87
+
88
+ # Structural netlist — accepts BLIF, .aag, .bench or exactor-netlist-v1 JSON
89
+ res = client.simplify_netlist(open("circuit.blif").read(),
90
+ fsm_minimize=True, fsm_init="0")
91
+
92
+ # Free dry-run analysis (0 SU)
93
+ print(client.analyze(["a","b","c"], [0,1,5,7]))
94
+ ```
95
+
96
+ `ExactorError` exposes `.status`, `.is_quota` (402), `.is_rate_limited` (429).
97
+
98
+ ---
99
+
100
+ ## What you can throw at it
101
+
102
+ - **`.pla`** — Espresso standard
103
+ - **`.json`** — `{variables, minterms, dont_cares}`
104
+ - **`.blif`** — ABC/Yosys `write_blif` output, straight in
105
+ - **`.aag`** — ASCII AIGER (Simplifier/SAT-sweeping tools)
106
+ - **`.bench`** — ISCAS bench (Simplifier native)
107
+ - **`exactor-netlist-v1`** — structural DAG from the `yosys-exactor` plugin, including sequential flop/latch cuts
108
+
109
+ Outputs: Verilog, VHDL, BLIF, xespresso ESOP, **Bristol** (ZK), **Circom** (ZK), self-checking **testbench** + equivalence certificate, Yosys script.
110
+
111
+ ---
112
+
113
+ ## CLI reference
114
+
115
+ ```bash
116
+ exactor login --token ek_... # store credentials
117
+ exactor whoami / balance # plan + SU balance
118
+ exactor minimize in.pla -o out.v # sync simplify (.pla/.json/.blif/.aag/.bench)
119
+ exactor minimize big.pla --async --wait # distributed job for large inputs
120
+ exactor minimize net.json --fsm-minimize --fsm-init 0
121
+ exactor status <job_id> # async job polling
122
+ ```
123
+
124
+ Engine knobs: `--max-sim-vars`, `--esop-budget`, `--no-fhe-cost-aware`, `--simplifier-prepass` / `--no-simplifier-prepass`, `--blind` (π/σ anonymized submission).
125
+
126
+ ---
127
+
128
+ ## Billing — light jobs are free
129
+
130
+ Jobs within the FREE envelope (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates) cost **0 SU on every plan** — rate-limited, not metered. SU are only consumed by heavy synthesis (33–128 vars, large netlists, FSM minimization at scale). See [credits-and-billing](https://exactor.tech) for the full model.
131
+
132
+ ---
133
+
134
+ ## Links
135
+
136
+ - **Service & console:** https://exactor.tech
137
+ - **Interactive API docs:** https://exactor.tech/public-swagger-ui
138
+ - **Getting started guide:** https://exactor.tech/GETTING_STARTED.md
139
+ - **Yosys plugin:** `yosys-exactor` (`exactor_netlist`, `exactor_spec`, `exactor_import`)
140
+
141
+ ---
142
+
143
+ *Proprietary client for the Exactor Cloud Engine. Python 3.8+, stdlib only.*
@@ -1,4 +1,4 @@
1
- GETTING_STARTED.md
1
+ PYPI_README.md
2
2
  README.md
3
3
  exactor_cli.py
4
4
  exactor_client.py
@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "exactor-cli"
7
- version = "1.28.1"
8
- description = "Exactor thin-client CLI — boolean logic minimization via the Exactor Cloud Engine (https://exactor.tech)"
9
- readme = "GETTING_STARTED.md"
7
+ version = "1.29.0"
8
+ description = "Exactor CLI & Python SDK — XOR-native Boolean minimization for ZK/FHE/MPC and EDA (https://exactor.tech)"
9
+ readme = "PYPI_README.md"
10
10
  requires-python = ">=3.8"
11
11
  license = { text = "Proprietary" }
12
12
  authors = [{ name = "Exactor Research" }]
13
- keywords = ["boolean", "logic-minimization", "xor", "esop", "synthesis", "zk", "fhe"]
13
+ keywords = ["boolean", "logic-minimization", "xor", "esop", "synthesis", "zk", "fhe", "mpc", "blif", "aiger", "eda", "verilog", "fsm"]
14
14
  classifiers = [
15
15
  "Development Status :: 4 - Beta",
16
16
  "Environment :: Console",
@@ -22,6 +22,7 @@ dependencies = []
22
22
 
23
23
  [project.urls]
24
24
  Homepage = "https://exactor.tech"
25
+ Documentation = "https://exactor.tech/GETTING_STARTED.md"
25
26
  API = "https://exactor.tech/public-swagger-ui"
26
27
 
27
28
  [project.scripts]
@@ -1,116 +0,0 @@
1
- # Getting Started — primera simplificación en ~2 minutos
2
-
3
- Cliente Python puro (stdlib, cero dependencias) contra la API hosted en **`https://exactor.tech`**. Sin compilar nada, sin Docker, sin `.env`.
4
-
5
- ## 1. Consigue una API key
6
-
7
- Regístrate gratis en [exactor.tech](https://exactor.tech) (o login si ya tienes cuenta) → **Console → API Keys → create `ek_...` key**.
8
-
9
- También sirve el JWT de sesión (`/api/auth/register` → `token`) como Bearer token.
10
-
11
- ## 2. Instala el cliente
12
-
13
- ```bash
14
- # Opción A — pip (recomendada; paquete `exactor-cli`)
15
- pip install exactor-cli # en PyPI; mientras tanto: pip install git+https://gitlab.com/exactorresearch/exactor/exactor-cloud-service-v128.git
16
-
17
- # Opción B — instaladores one-liner
18
- curl -sSL https://exactor.tech/install.sh | bash # Linux / macOS
19
- irm https://exactor.tech/install.ps1 | iex # Windows PowerShell
20
-
21
- # Opción C — sin instalar: baja el archivo único
22
- curl -sSL https://exactor.tech/exactor_cli.py -o exactor_cli.py
23
- ```
24
-
25
- Requiere **Python 3.8+**, nada más (`urllib`/`json` de la stdlib).
26
-
27
- ## 3. Login y minimiza
28
-
29
- ```bash
30
- exactor login --token ek_TU_API_KEY # guarda config en ~/.exactor/
31
- exactor whoami # verifica tier y balance SU
32
- exactor minimize circuit.pla -o out.v # .pla, .json o expresión
33
- ```
34
-
35
- Salida real:
36
-
37
- ```
38
- [*] Circuit parsed: 4 inputs, 6 minterms.
39
- EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
40
- Solver Latency: 2195 ms
41
- Gate Reduction: 45.0%
42
- SU Consumed: 1 SU
43
- Result Equation: !(x2 ^ x1) & !x0 + (x3 ^ x2) & !x0
44
- [*] Written synthesized output to: out.v
45
- ```
46
-
47
- O directo con curl — **sin instalar nada**:
48
-
49
- ```bash
50
- curl -X POST https://exactor.tech/api/simplify \
51
- -H "Authorization: Bearer ek_TU_API_KEY" \
52
- -H "Content-Type: application/json" \
53
- -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
54
- ```
55
-
56
- ## Formato de entrada
57
-
58
- - `variables`: **array de nombres**; `variables[0]` es el bit **más significativo** del índice de minterm (xespresso v1, MSB-first).
59
- - `minterms`: enteros `0..2^n` del conjunto ON. `dont_cares` para "don't care".
60
- - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists estructurales — `exactor-netlist-v1` JSON (salida de `exactor_netlist -format json` del plugin Yosys, incluye cortes secuenciales con `flops`), **BLIF** (`.names`, salida de `write_blif` en ABC/Yosys), **AIGER ASCII** `.aag` (salida de Simplifier/`write_aiger`; los latches se tratan como flop-cut) e **ISCAS `.bench`** — el servidor autodetecta el formato por contenido, sin conversión.
61
- - `POST /api/simplify/netlist` devuelve por output `blif` (emit `"blif"`): BLIF listo para ABC/Yosys.
62
-
63
- ## Como librería Python
64
-
65
- El mismo paquete expone `exactor_client` para integrar la API en tu código:
66
-
67
- ```python
68
- from exactor import ExactorClient, ExactorError # o: from exactor_client import ...
69
-
70
- client = ExactorClient(token="ek_...") # o EXACTOR_TOKEN / ~/.exactor/config.json
71
-
72
- # Función booleana por minterms
73
- res = client.simplify(variables=["a","b","c","d"],
74
- minterms=[0,1,2,5,6,7],
75
- emit=["verilog","metrics"])
76
- print(res["result"], "| su_used:", res["su_used"])
77
-
78
- # Pre-análisis gratis (0 SU)
79
- print(client.analyze(["a","b","c"], [0,1,5,7]))
80
-
81
- # Netlist estructural con FSM (JSON exactor-netlist-v1 o BLIF/AAG/bench)
82
- res = client.simplify_netlist(open("net.json").read(),
83
- fsm_minimize=True, fsm_init="0")
84
- print(res["fsm_analysis"], res["minimized_state_bits"])
85
-
86
- # Cuenta
87
- print(client.me(), client.balance())
88
- ```
89
-
90
- `ExactorError` lleva `.status` y `.payload`; `.is_quota` (402) e `.is_rate_limited` (429) facilitan el manejo de errores. Resolución de token: argumento → `EXACTOR_TOKEN` env → `EXACTOR_ENDPOINT` env para endpoint → `~/.exactor/config.json`.
91
-
92
- ## Variantes del CLI
93
-
94
- ```bash
95
- exactor minimize big.pla --async --wait # job en cluster para >32 vars / funciones grandes
96
- exactor status <job_id> # consulta un job async
97
- exactor balance # saldo SU del plan
98
- exactor minimize net.json --max-sim-vars 24 --esop-budget 200000 # knobs del engine netlist
99
- exactor minimize net.json --fsm-minimize # (vía API: fsm_minimize/fsm_init en el payload)
100
- ```
101
-
102
- ## Billing en una línea
103
-
104
- Jobs ligeros (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates / ≤64 out) = **0 SU en todos los planes** — el registro FREE te da acceso inmediato. Las SU solo se consumen en jobs pesados; el tier FREE tiene rate limit diario.
105
-
106
- ## Troubleshooting
107
-
108
- | Síntoma | Causa | Fix |
109
- |---|---|---|
110
- | `401 Access Denied` | Token inválido/ausente | `exactor login --token ek_...` o regístrate en exactor.tech |
111
- | `403` / límites | Supera caps del plan FREE | Sube de tier (PRO/TEAM) |
112
- | `402 Insufficient SU` | Job pesado sin saldo | Los ligeros no cobran; PRO incluye 10K SU/mes para pesados |
113
- | `429 RATE_LIMITED` | Rate limit diario del plan en jobs ligeros | Espera al día siguiente o sube de tier |
114
- | `variables` rechazado | Entero en vez de array de nombres | `"variables": ["a","b",...]` — `[0]` es MSB |
115
-
116
- Ver también: `README.md` (referencia de endpoints), `api.html` (snippets curl/Python/JS), Swagger UI en `https://exactor.tech/public-swagger-ui`, `docs/exactor/credits-and-billing.md` (modelo SU v3).
@@ -1,133 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: exactor-cli
3
- Version: 1.28.1
4
- Summary: Exactor thin-client CLI — boolean logic minimization via the Exactor Cloud Engine (https://exactor.tech)
5
- Author: Exactor Research
6
- License: Proprietary
7
- Project-URL: Homepage, https://exactor.tech
8
- Project-URL: API, https://exactor.tech/public-swagger-ui
9
- Keywords: boolean,logic-minimization,xor,esop,synthesis,zk,fhe
10
- Classifier: Development Status :: 4 - Beta
11
- Classifier: Environment :: Console
12
- Classifier: Intended Audience :: Science/Research
13
- Classifier: Programming Language :: Python :: 3
14
- Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
15
- Requires-Python: >=3.8
16
- Description-Content-Type: text/markdown
17
-
18
- # Getting Started — primera simplificación en ~2 minutos
19
-
20
- Cliente Python puro (stdlib, cero dependencias) contra la API hosted en **`https://exactor.tech`**. Sin compilar nada, sin Docker, sin `.env`.
21
-
22
- ## 1. Consigue una API key
23
-
24
- Regístrate gratis en [exactor.tech](https://exactor.tech) (o login si ya tienes cuenta) → **Console → API Keys → create `ek_...` key**.
25
-
26
- También sirve el JWT de sesión (`/api/auth/register` → `token`) como Bearer token.
27
-
28
- ## 2. Instala el cliente
29
-
30
- ```bash
31
- # Opción A — pip (recomendada; paquete `exactor-cli`)
32
- pip install exactor-cli # en PyPI; mientras tanto: pip install git+https://gitlab.com/exactorresearch/exactor/exactor-cloud-service-v128.git
33
-
34
- # Opción B — instaladores one-liner
35
- curl -sSL https://exactor.tech/install.sh | bash # Linux / macOS
36
- irm https://exactor.tech/install.ps1 | iex # Windows PowerShell
37
-
38
- # Opción C — sin instalar: baja el archivo único
39
- curl -sSL https://exactor.tech/exactor_cli.py -o exactor_cli.py
40
- ```
41
-
42
- Requiere **Python 3.8+**, nada más (`urllib`/`json` de la stdlib).
43
-
44
- ## 3. Login y minimiza
45
-
46
- ```bash
47
- exactor login --token ek_TU_API_KEY # guarda config en ~/.exactor/
48
- exactor whoami # verifica tier y balance SU
49
- exactor minimize circuit.pla -o out.v # .pla, .json o expresión
50
- ```
51
-
52
- Salida real:
53
-
54
- ```
55
- [*] Circuit parsed: 4 inputs, 6 minterms.
56
- EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
57
- Solver Latency: 2195 ms
58
- Gate Reduction: 45.0%
59
- SU Consumed: 1 SU
60
- Result Equation: !(x2 ^ x1) & !x0 + (x3 ^ x2) & !x0
61
- [*] Written synthesized output to: out.v
62
- ```
63
-
64
- O directo con curl — **sin instalar nada**:
65
-
66
- ```bash
67
- curl -X POST https://exactor.tech/api/simplify \
68
- -H "Authorization: Bearer ek_TU_API_KEY" \
69
- -H "Content-Type: application/json" \
70
- -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
71
- ```
72
-
73
- ## Formato de entrada
74
-
75
- - `variables`: **array de nombres**; `variables[0]` es el bit **más significativo** del índice de minterm (xespresso v1, MSB-first).
76
- - `minterms`: enteros `0..2^n` del conjunto ON. `dont_cares` para "don't care".
77
- - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists estructurales — `exactor-netlist-v1` JSON (salida de `exactor_netlist -format json` del plugin Yosys, incluye cortes secuenciales con `flops`), **BLIF** (`.names`, salida de `write_blif` en ABC/Yosys), **AIGER ASCII** `.aag` (salida de Simplifier/`write_aiger`; los latches se tratan como flop-cut) e **ISCAS `.bench`** — el servidor autodetecta el formato por contenido, sin conversión.
78
- - `POST /api/simplify/netlist` devuelve por output `blif` (emit `"blif"`): BLIF listo para ABC/Yosys.
79
-
80
- ## Como librería Python
81
-
82
- El mismo paquete expone `exactor_client` para integrar la API en tu código:
83
-
84
- ```python
85
- from exactor import ExactorClient, ExactorError # o: from exactor_client import ...
86
-
87
- client = ExactorClient(token="ek_...") # o EXACTOR_TOKEN / ~/.exactor/config.json
88
-
89
- # Función booleana por minterms
90
- res = client.simplify(variables=["a","b","c","d"],
91
- minterms=[0,1,2,5,6,7],
92
- emit=["verilog","metrics"])
93
- print(res["result"], "| su_used:", res["su_used"])
94
-
95
- # Pre-análisis gratis (0 SU)
96
- print(client.analyze(["a","b","c"], [0,1,5,7]))
97
-
98
- # Netlist estructural con FSM (JSON exactor-netlist-v1 o BLIF/AAG/bench)
99
- res = client.simplify_netlist(open("net.json").read(),
100
- fsm_minimize=True, fsm_init="0")
101
- print(res["fsm_analysis"], res["minimized_state_bits"])
102
-
103
- # Cuenta
104
- print(client.me(), client.balance())
105
- ```
106
-
107
- `ExactorError` lleva `.status` y `.payload`; `.is_quota` (402) e `.is_rate_limited` (429) facilitan el manejo de errores. Resolución de token: argumento → `EXACTOR_TOKEN` env → `EXACTOR_ENDPOINT` env para endpoint → `~/.exactor/config.json`.
108
-
109
- ## Variantes del CLI
110
-
111
- ```bash
112
- exactor minimize big.pla --async --wait # job en cluster para >32 vars / funciones grandes
113
- exactor status <job_id> # consulta un job async
114
- exactor balance # saldo SU del plan
115
- exactor minimize net.json --max-sim-vars 24 --esop-budget 200000 # knobs del engine netlist
116
- exactor minimize net.json --fsm-minimize # (vía API: fsm_minimize/fsm_init en el payload)
117
- ```
118
-
119
- ## Billing en una línea
120
-
121
- Jobs ligeros (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates / ≤64 out) = **0 SU en todos los planes** — el registro FREE te da acceso inmediato. Las SU solo se consumen en jobs pesados; el tier FREE tiene rate limit diario.
122
-
123
- ## Troubleshooting
124
-
125
- | Síntoma | Causa | Fix |
126
- |---|---|---|
127
- | `401 Access Denied` | Token inválido/ausente | `exactor login --token ek_...` o regístrate en exactor.tech |
128
- | `403` / límites | Supera caps del plan FREE | Sube de tier (PRO/TEAM) |
129
- | `402 Insufficient SU` | Job pesado sin saldo | Los ligeros no cobran; PRO incluye 10K SU/mes para pesados |
130
- | `429 RATE_LIMITED` | Rate limit diario del plan en jobs ligeros | Espera al día siguiente o sube de tier |
131
- | `variables` rechazado | Entero en vez de array de nombres | `"variables": ["a","b",...]` — `[0]` es MSB |
132
-
133
- Ver también: `README.md` (referencia de endpoints), `api.html` (snippets curl/Python/JS), Swagger UI en `https://exactor.tech/public-swagger-ui`, `docs/exactor/credits-and-billing.md` (modelo SU v3).
@@ -1,133 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: exactor-cli
3
- Version: 1.28.1
4
- Summary: Exactor thin-client CLI — boolean logic minimization via the Exactor Cloud Engine (https://exactor.tech)
5
- Author: Exactor Research
6
- License: Proprietary
7
- Project-URL: Homepage, https://exactor.tech
8
- Project-URL: API, https://exactor.tech/public-swagger-ui
9
- Keywords: boolean,logic-minimization,xor,esop,synthesis,zk,fhe
10
- Classifier: Development Status :: 4 - Beta
11
- Classifier: Environment :: Console
12
- Classifier: Intended Audience :: Science/Research
13
- Classifier: Programming Language :: Python :: 3
14
- Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
15
- Requires-Python: >=3.8
16
- Description-Content-Type: text/markdown
17
-
18
- # Getting Started — primera simplificación en ~2 minutos
19
-
20
- Cliente Python puro (stdlib, cero dependencias) contra la API hosted en **`https://exactor.tech`**. Sin compilar nada, sin Docker, sin `.env`.
21
-
22
- ## 1. Consigue una API key
23
-
24
- Regístrate gratis en [exactor.tech](https://exactor.tech) (o login si ya tienes cuenta) → **Console → API Keys → create `ek_...` key**.
25
-
26
- También sirve el JWT de sesión (`/api/auth/register` → `token`) como Bearer token.
27
-
28
- ## 2. Instala el cliente
29
-
30
- ```bash
31
- # Opción A — pip (recomendada; paquete `exactor-cli`)
32
- pip install exactor-cli # en PyPI; mientras tanto: pip install git+https://gitlab.com/exactorresearch/exactor/exactor-cloud-service-v128.git
33
-
34
- # Opción B — instaladores one-liner
35
- curl -sSL https://exactor.tech/install.sh | bash # Linux / macOS
36
- irm https://exactor.tech/install.ps1 | iex # Windows PowerShell
37
-
38
- # Opción C — sin instalar: baja el archivo único
39
- curl -sSL https://exactor.tech/exactor_cli.py -o exactor_cli.py
40
- ```
41
-
42
- Requiere **Python 3.8+**, nada más (`urllib`/`json` de la stdlib).
43
-
44
- ## 3. Login y minimiza
45
-
46
- ```bash
47
- exactor login --token ek_TU_API_KEY # guarda config en ~/.exactor/
48
- exactor whoami # verifica tier y balance SU
49
- exactor minimize circuit.pla -o out.v # .pla, .json o expresión
50
- ```
51
-
52
- Salida real:
53
-
54
- ```
55
- [*] Circuit parsed: 4 inputs, 6 minterms.
56
- EXACTOR CLOUD // SYNTHESIS COMPLETE (FORMALLY VERIFIED)
57
- Solver Latency: 2195 ms
58
- Gate Reduction: 45.0%
59
- SU Consumed: 1 SU
60
- Result Equation: !(x2 ^ x1) & !x0 + (x3 ^ x2) & !x0
61
- [*] Written synthesized output to: out.v
62
- ```
63
-
64
- O directo con curl — **sin instalar nada**:
65
-
66
- ```bash
67
- curl -X POST https://exactor.tech/api/simplify \
68
- -H "Authorization: Bearer ek_TU_API_KEY" \
69
- -H "Content-Type: application/json" \
70
- -d '{"variables":["a","b","c","d"],"minterms":[0,1,2,5,6,7],"emit":["verilog"]}'
71
- ```
72
-
73
- ## Formato de entrada
74
-
75
- - `variables`: **array de nombres**; `variables[0]` es el bit **más significativo** del índice de minterm (xespresso v1, MSB-first).
76
- - `minterms`: enteros `0..2^n` del conjunto ON. `dont_cares` para "don't care".
77
- - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists estructurales — `exactor-netlist-v1` JSON (salida de `exactor_netlist -format json` del plugin Yosys, incluye cortes secuenciales con `flops`), **BLIF** (`.names`, salida de `write_blif` en ABC/Yosys), **AIGER ASCII** `.aag` (salida de Simplifier/`write_aiger`; los latches se tratan como flop-cut) e **ISCAS `.bench`** — el servidor autodetecta el formato por contenido, sin conversión.
78
- - `POST /api/simplify/netlist` devuelve por output `blif` (emit `"blif"`): BLIF listo para ABC/Yosys.
79
-
80
- ## Como librería Python
81
-
82
- El mismo paquete expone `exactor_client` para integrar la API en tu código:
83
-
84
- ```python
85
- from exactor import ExactorClient, ExactorError # o: from exactor_client import ...
86
-
87
- client = ExactorClient(token="ek_...") # o EXACTOR_TOKEN / ~/.exactor/config.json
88
-
89
- # Función booleana por minterms
90
- res = client.simplify(variables=["a","b","c","d"],
91
- minterms=[0,1,2,5,6,7],
92
- emit=["verilog","metrics"])
93
- print(res["result"], "| su_used:", res["su_used"])
94
-
95
- # Pre-análisis gratis (0 SU)
96
- print(client.analyze(["a","b","c"], [0,1,5,7]))
97
-
98
- # Netlist estructural con FSM (JSON exactor-netlist-v1 o BLIF/AAG/bench)
99
- res = client.simplify_netlist(open("net.json").read(),
100
- fsm_minimize=True, fsm_init="0")
101
- print(res["fsm_analysis"], res["minimized_state_bits"])
102
-
103
- # Cuenta
104
- print(client.me(), client.balance())
105
- ```
106
-
107
- `ExactorError` lleva `.status` y `.payload`; `.is_quota` (402) e `.is_rate_limited` (429) facilitan el manejo de errores. Resolución de token: argumento → `EXACTOR_TOKEN` env → `EXACTOR_ENDPOINT` env para endpoint → `~/.exactor/config.json`.
108
-
109
- ## Variantes del CLI
110
-
111
- ```bash
112
- exactor minimize big.pla --async --wait # job en cluster para >32 vars / funciones grandes
113
- exactor status <job_id> # consulta un job async
114
- exactor balance # saldo SU del plan
115
- exactor minimize net.json --max-sim-vars 24 --esop-budget 200000 # knobs del engine netlist
116
- exactor minimize net.json --fsm-minimize # (vía API: fsm_minimize/fsm_init en el payload)
117
- ```
118
-
119
- ## Billing en una línea
120
-
121
- Jobs ligeros (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates / ≤64 out) = **0 SU en todos los planes** — el registro FREE te da acceso inmediato. Las SU solo se consumen en jobs pesados; el tier FREE tiene rate limit diario.
122
-
123
- ## Troubleshooting
124
-
125
- | Síntoma | Causa | Fix |
126
- |---|---|---|
127
- | `401 Access Denied` | Token inválido/ausente | `exactor login --token ek_...` o regístrate en exactor.tech |
128
- | `403` / límites | Supera caps del plan FREE | Sube de tier (PRO/TEAM) |
129
- | `402 Insufficient SU` | Job pesado sin saldo | Los ligeros no cobran; PRO incluye 10K SU/mes para pesados |
130
- | `429 RATE_LIMITED` | Rate limit diario del plan en jobs ligeros | Espera al día siguiente o sube de tier |
131
- | `variables` rechazado | Entero en vez de array de nombres | `"variables": ["a","b",...]` — `[0]` es MSB |
132
-
133
- Ver también: `README.md` (referencia de endpoints), `api.html` (snippets curl/Python/JS), Swagger UI en `https://exactor.tech/public-swagger-ui`, `docs/exactor/credits-and-billing.md` (modelo SU v3).
File without changes
File without changes