Lo que necesitas
- Rust 1.92 o posterior. El espacio de trabajo usa la edición 2024, así que una cadena de herramientas más antigua se detiene en el manifiesto.
rustup updatepone la tuya al día. - Un compilador C, para el crate TLS que usan las descargas de distribuidor y modelos: las herramientas de línea de comandos de Xcode en macOS, las herramientas de compilación de MSVC en Windows,
gccoclangen Linux.
No hay bibliotecas de sistema contra las que enlazar. El visor carga X11 o Wayland en tiempo de ejecución, y los solvers de GPU acceden a Vulkan, Metal o DirectX 12 a través de wgpu.
Instala con cargo
cargo install --git https://github.com/v0l/agentee agenteeEso compila el binario agentee en modo de liberación y lo coloca en ~/.cargo/bin. Ejecuta el mismo comando de nuevo para actualizar.
Desde un clon
Trabaja desde un clon cuando quieras los ejemplos, o para cambiar agentee mismo:
git clone https://github.com/v0l/agentee
cd agentee
cargo install --path crates/agenteecargo build --release -p agentee compila sin instalar, en target/release/agentee.
Cada paquete de fabricación lleva agentee vX.Y.Z-HASH en su serigrafía. El hash es el commit desde el que se compiló el binario, con -dirty cuando el árbol tenía cambios sin confirmar, para que una placa siempre diga qué fuente la compiló.
El espacio de trabajo
| crate | qué contiene |
|---|---|
agentee | la CLI y el servidor MCP |
agentee-core | unidades, el modelo de archivo, resolución y verificación, las calculadoras |
agentee-kicad | el lector de expresiones s y los importadores de .kicad_sym, .kicad_mod y .kicad_pcb |
agentee-layout | colocación y ruteo: fases sobre un modelo de placa y una puntuación |
agentee-sim | los solvers de campos de GPU: la sección transversal 2D y el FDTD 3D en wgpu |
agentee-fab | Gerbers, archivos de taladro, BOM, colocación y notas de fabricación |
agentee-parts | stock de distribuidor, precios y alternativas más baratas desde Mouser y Farnell |
agentee-view | el visor egui y el renderizador PNG sin cabeza |
agentee-3d | modelos de piezas STEP y VRML, búsqueda y descarga |
Pruebas y benchmarks
cargo test --workspaceEl relleno de zonas tiene un benchmark por fase (clip, overlay, min_width, probe, keep_connected, rasterize, fill_zone) sobre cada zona de los ejemplos, además de check_zones y una carga de proyecto completo. Filtra a la fase en la que estás trabajando:
cargo bench -p agentee-core --bench fill -- --quick 'fill/hackrf-pro/overlay'
cargo bench -p agentee-core --bench fill -- 'load/'Datos de fabricación
Los presets de apilamiento provienen de los datos publicados por los fabricantes, que cambian con el tiempo. crates/agentee-core/stackups/fetch.py los vuelve a obtener desde JLCPCB y PCBWay.