[BUG]

[restneeded]

📋 Bug Summary

Brief Description:
I have tried pip pipx and git clone, this shizzz dont work lmao

Severity Level:

• [x ] Critical - System crashes, data loss, or complete failure
• High - Major functionality broken, significant impact
• Medium - Minor functionality issues, workarounds available
• Low - Cosmetic issues, minor inconveniences

📦 Environment Details

Run help_ticket.sh and give the output

🚨 Problem Description

What happened?

Error Messages/Logs:

topg@topg:~$ pipx uninstall pcileechfwgenerator
uninstalled pcileechfwgenerator! ✨ 🌟 ✨
topg@topg:~$ pipx install --force 'pcileechfwgenerator[tui]'
  installed package pcileechfwgenerator 0.14.9, installed using Python 3.12.3
  These apps are now globally available
    - pcileech
    - pcileech-build
    - pcileech-generate
    - pcileech-tui
done! ✨ 🌟 ✨
topg@topg:~$ pipx list --include-injected
venvs are in /home/topg/.local/share/pipx/venvs
apps are exposed on your $PATH at /home/topg/.local/bin
manual pages are exposed at /home/topg/.local/share/man
   package pcileechfwgenerator 0.14.9, installed using Python 3.12.3
    - pcileech
    - pcileech-build
    - pcileech-generate
    - pcileech-tui
topg@topg:~$ ls /home/topg/.local/pipx/venvs/pcileechfwgenerator/bin/
ls: cannot access '/home/topg/.local/pipx/venvs/pcileechfwgenerator/bin/': No such file or directory
topg@topg:~$ cd generate
topg@topg:~/generate$ python3 -m venv ~/.pcileech-venv
topg@topg:~/generate$ source ~/.pcileech-venv/bin/activate
(.pcileech-venv) topg@topg:~/generate$ 
(.pcileech-venv) topg@topg:~/generate$ pip install pcileechfwgenerator[tui]
Collecting pcileechfwgenerator[tui]
  Using cached pcileechfwgenerator-0.14.9-py3-none-any.whl.metadata (15 kB)
Collecting psutil>=5.9.0 (from pcileechfwgenerator[tui])
  Using cached psutil-7.2.2-cp36-abi3-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl.metadata (22 kB)
Collecting pydantic>=2.0.0 (from pcileechfwgenerator[tui])
  Using cached pydantic-2.12.5-py3-none-any.whl.metadata (90 kB)
Collecting aiofiles>=23.0.0 (from pcileechfwgenerator[tui])
  Using cached aiofiles-25.1.0-py3-none-any.whl.metadata (6.3 kB)
Collecting jinja2>=3.1.0 (from pcileechfwgenerator[tui])
  Using cached jinja2-3.1.6-py3-none-any.whl.metadata (2.9 kB)
Collecting PyYAML>=6.0.0 (from pcileechfwgenerator[tui])
  Using cached pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.metadata (2.4 kB)
Collecting colorlog>=6.7.0 (from pcileechfwgenerator[tui])
  Using cached colorlog-6.10.1-py3-none-any.whl.metadata (11 kB)
Collecting typing_extensions>=4.0.0 (from pcileechfwgenerator[tui])
  Using cached typing_extensions-4.15.0-py3-none-any.whl.metadata (3.3 kB)
Collecting textual>=4.0.0 (from pcileechfwgenerator[tui])
  Using cached textual-7.5.0-py3-none-any.whl.metadata (9.1 kB)
Collecting rich>=13.0.0 (from pcileechfwgenerator[tui])
  Using cached rich-14.3.2-py3-none-any.whl.metadata (18 kB)
Collecting watchdog>=3.0.0 (from pcileechfwgenerator[tui])
  Using cached watchdog-6.0.0-py3-none-manylinux2014_x86_64.whl.metadata (44 kB)
Collecting MarkupSafe>=2.0 (from jinja2>=3.1.0->pcileechfwgenerator[tui])
  Using cached markupsafe-3.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.metadata (2.7 kB)
Collecting annotated-types>=0.6.0 (from pydantic>=2.0.0->pcileechfwgenerator[tui])
  Using cached annotated_types-0.7.0-py3-none-any.whl.metadata (15 kB)
Collecting pydantic-core==2.41.5 (from pydantic>=2.0.0->pcileechfwgenerator[tui])
  Using cached pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (7.3 kB)
Collecting typing-inspection>=0.4.2 (from pydantic>=2.0.0->pcileechfwgenerator[tui])
  Using cached typing_inspection-0.4.2-py3-none-any.whl.metadata (2.6 kB)
Collecting markdown-it-py>=2.2.0 (from rich>=13.0.0->pcileechfwgenerator[tui])
  Using cached markdown_it_py-4.0.0-py3-none-any.whl.metadata (7.3 kB)
Collecting pygments<3.0.0,>=2.13.0 (from rich>=13.0.0->pcileechfwgenerator[tui])
  Using cached pygments-2.19.2-py3-none-any.whl.metadata (2.5 kB)
Collecting mdit-py-plugins (from textual>=4.0.0->pcileechfwgenerator[tui])
  Using cached mdit_py_plugins-0.5.0-py3-none-any.whl.metadata (2.8 kB)
Collecting platformdirs<5,>=3.6.0 (from textual>=4.0.0->pcileechfwgenerator[tui])
  Using cached platformdirs-4.5.1-py3-none-any.whl.metadata (12 kB)
Collecting mdurl~=0.1 (from markdown-it-py>=2.2.0->rich>=13.0.0->pcileechfwgenerator[tui])
  Using cached mdurl-0.1.2-py3-none-any.whl.metadata (1.6 kB)
Collecting linkify-it-py<3,>=1 (from markdown-it-py[linkify]>=2.1.0->textual>=4.0.0->pcileechfwgenerator[tui])
  Using cached linkify_it_py-2.0.3-py3-none-any.whl.metadata (8.5 kB)
Collecting uc-micro-py (from linkify-it-py<3,>=1->markdown-it-py[linkify]>=2.1.0->textual>=4.0.0->pcileechfwgenerator[tui])
  Using cached uc_micro_py-1.0.3-py3-none-any.whl.metadata (2.0 kB)
Using cached aiofiles-25.1.0-py3-none-any.whl (14 kB)
Using cached colorlog-6.10.1-py3-none-any.whl (11 kB)
Using cached jinja2-3.1.6-py3-none-any.whl (134 kB)
Using cached psutil-7.2.2-cp36-abi3-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl (155 kB)
Using cached pydantic-2.12.5-py3-none-any.whl (463 kB)
Using cached pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.1 MB)
Using cached pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (807 kB)
Using cached rich-14.3.2-py3-none-any.whl (309 kB)
Using cached textual-7.5.0-py3-none-any.whl (718 kB)
Using cached typing_extensions-4.15.0-py3-none-any.whl (44 kB)
Using cached watchdog-6.0.0-py3-none-manylinux2014_x86_64.whl (79 kB)
Using cached pcileechfwgenerator-0.14.9-py3-none-any.whl (771 kB)
Using cached annotated_types-0.7.0-py3-none-any.whl (13 kB)
Using cached markdown_it_py-4.0.0-py3-none-any.whl (87 kB)
Using cached markupsafe-3.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (22 kB)
Using cached platformdirs-4.5.1-py3-none-any.whl (18 kB)
Using cached pygments-2.19.2-py3-none-any.whl (1.2 MB)
Using cached typing_inspection-0.4.2-py3-none-any.whl (14 kB)
Using cached mdit_py_plugins-0.5.0-py3-none-any.whl (57 kB)
Using cached linkify_it_py-2.0.3-py3-none-any.whl (19 kB)
Using cached mdurl-0.1.2-py3-none-any.whl (10.0 kB)
Using cached uc_micro_py-1.0.3-py3-none-any.whl (6.2 kB)
Installing collected packages: watchdog, uc-micro-py, typing_extensions, PyYAML, pygments, psutil, platformdirs, mdurl, MarkupSafe, colorlog, annotated-types, aiofiles, typing-inspection, pydantic-core, markdown-it-py, linkify-it-py, jinja2, rich, pydantic, mdit-py-plugins, textual, pcileechfwgenerator
Successfully installed MarkupSafe-3.0.3 PyYAML-6.0.3 aiofiles-25.1.0 annotated-types-0.7.0 colorlog-6.10.1 jinja2-3.1.6 linkify-it-py-2.0.3 markdown-it-py-4.0.0 mdit-py-plugins-0.5.0 mdurl-0.1.2 pcileechfwgenerator-0.14.9 platformdirs-4.5.1 psutil-7.2.2 pydantic-2.12.5 pydantic-core-2.41.5 pygments-2.19.2 rich-14.3.2 textual-7.5.0 typing-inspection-0.4.2 typing_extensions-4.15.0 uc-micro-py-1.0.3 watchdog-6.0.0
(.pcileech-venv) topg@topg:~/generate$ pcileech version
Error: Could not import pcileech main function: No module named 'pcileech'
Please ensure the package is properly installed.

Steps to Reproduce:

Command Line Used:

# Paste the exact command(s) that triggered the issue

Configuration Details:

🎯 Expected Behavior

What should happen instead?

Reference Implementation:

🔬 Additional Context

Frequency:

• Always reproducible
• Intermittent (occurs sometimes)
• Rare (occurred once or twice)

Impact Assessment:

• Blocks development/testing
• Affects firmware functionality
• Synthesis/build failures
• Runtime errors
• Performance issues

Workaround Available:

• Yes (please describe below)
• No

Workaround Description:

📎 Attachments

Required Files:

• config.json (sanitized)
• generate.log or relevant log files
• Error screenshots or terminal output

Optional Files:

• Custom .tcl files
• Custom .sv files
• Synthesis reports
• Waveform captures
• Core dump files

🛠️ Debugging Information

Commands Run for Debugging:

# List any debugging commands you tried
# e.g., python pcileech.py --verbose, vivado -version, etc.

System Information:

# Output of system info commands (optional)
# e.g., uname -a, python --version, pip list | grep -i pci

✅ Pre-submission Checklist

I have:

• Checked that I'm using the latest version from the main branch
• Searched for existing similar issues
• Read the relevant documentation/wiki pages
• Included all required information above
• Removed any sensitive/personal information
• Tested with minimal reproduction case
• Verified this isn't a configuration issue

Module-specific checks (if applicable):

• device_emulator - Checked device configuration and capabilities
• cap_parser - Verified PCI capability parsing
• svgen - Checked SystemVerilog generation
• flash - Verified flash operations and board connectivity
• vfio - Checked VFIO driver binding and permissions

🏷️ Labels

Issue Type:

• Synthesis Error
• Runtime Error
• Configuration Issue
• Documentation Issue
• Feature Request
• Performance Issue

Component:

• Core Generator
• Device Emulation
• Capability Parser
• SystemVerilog Generation
• Flash Operations
• VFIO Integration
• TUI Interface
• Build System

[github-actions]

The GitHub issue describes a critical bug where the user is unable to successfully install and use the pcileechfwgenerator package despite attempting multiple installation methods (via pip, pipx, and git clone). While the installation appears successful, the executables or modules required are not properly accessible (e.g., missing binaries in the expected paths and import errors, such as No module named pcileech). The issue persists even after using a virtual environment and explicitly reinstalling the package. The user provided detailed error logs, including terminal outputs and information about their environment, and flagged the issue as critical, as it results in a complete failure to use the tool as intended. Further investigation is needed to identify the root cause and resolve the problem.

[restneeded]

the closest i got to using it was doing the git clone way but build fails because it isnt calling the sub modules correctly. like are we building broken stuff

[restneeded]

this is the closest we get to using your stuff but this is where its still failing across all boards
ly
17:28:29 │ INFO │ [BUILD] ➤ Starting template_validation...
17:28:29 │ INFO │ [TEMPLATE] Validating board: pcileech_enigma_x1
17:28:29 │ WARNING│ [TEMPLATE] Board directory not found: pcileech_enigma_x1
17:28:29 │ WARNING│ [TEMPLATE] Board template validation failed - build may fail

[restneeded]

i can do pcileech_75t484_x1 same message

[restneeded]

i fixed this guys stuff lmao, gatekeeping though