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.
- exactor_cli-1.29.0/PKG-INFO +143 -0
- exactor_cli-1.29.0/PYPI_README.md +125 -0
- exactor_cli-1.29.0/exactor_cli.egg-info/PKG-INFO +143 -0
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/exactor_cli.egg-info/SOURCES.txt +1 -1
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/pyproject.toml +5 -4
- exactor_cli-1.28.1/GETTING_STARTED.md +0 -116
- exactor_cli-1.28.1/PKG-INFO +0 -133
- exactor_cli-1.28.1/exactor_cli.egg-info/PKG-INFO +0 -133
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/README.md +0 -0
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/exactor/__init__.py +0 -0
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/exactor/client.py +0 -0
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/exactor_cli.egg-info/dependency_links.txt +0 -0
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/exactor_cli.egg-info/entry_points.txt +0 -0
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/exactor_cli.egg-info/top_level.txt +0 -0
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/exactor_cli.py +0 -0
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/exactor_client.py +0 -0
- {exactor_cli-1.28.1 → exactor_cli-1.29.0}/setup.cfg +0 -0
|
@@ -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.*
|
|
@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "exactor-cli"
|
|
7
|
-
version = "1.
|
|
8
|
-
description = "Exactor
|
|
9
|
-
readme = "
|
|
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).
|
exactor_cli-1.28.1/PKG-INFO
DELETED
|
@@ -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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|