Xenotools Workflow Setup: Difference between revisions

From Catcliffe Development
Jump to navigation Jump to search
(Created page with "{{menuSymbioPoietrix}} <div style="float:right; width:425PX;"> __TOC__ </div> <div style="background-color:azure; border:1px outset azure; padding:0 20px; max-width:860px; margin:0 auto; "> = <big>'''workflow.readme.txt'''</big> = '''''XenoTools Quantum-Semantic Development Environment Setup Created by: XenoEngineer & Claude Last Updated: 2024-11-02 == Environment Setup== # Navigate to project root cd C:\Users\donem\Desktop\projects\python\xenotools   # Cr...")
 
mNo edit summary
 
(One intermediate revision by the same user not shown)
Line 12: Line 12:


== Environment Setup==
== Environment Setup==
# Navigate to project root
; Navigate to project root
  cd C:\Users\donem\Desktop\projects\python\xenotools
  cd C:\Users\donem\Desktop\projects\python\xenotools
  &nbsp;
   
# Create/activate virtual environment (if not exists)
; Create/activate virtual environment (if not exists)
  python -m venv venv
  python -m venv venv
  .\venv\Scripts\activate
  .\venv\Scripts\activate
  &nbsp;
  &nbsp;
# Verify activation - should see (venv) in prompt
 
; Verify activation - should see (venv) in prompt
  (venv) C:\Users\donem\Desktop\projects\python\xenotools>
  (venv) C:\Users\donem\Desktop\projects\python\xenotools>




== Dependencies Installation==
== Dependencies Installation==
# Install all required packages
; Install all required packages
  pip install anthropic python-dotenv pyyaml pandas numpy matplotlib seaborn
  pip install anthropic python-dotenv pyyaml pandas numpy matplotlib seaborn
  &nbsp;
  &nbsp;
# Verify package installation
 
; Verify package installation
  pip list
  pip list


== Project Structure Creation ==
== Project Structure Creation ==
# Ensure directories exist
; Ensure directories exist
  mkdir pipeline speak_specs mind_models
  mkdir pipeline speak_specs mind_models
  mkdir test_data test_output
  mkdir test_data test_output
  &nbsp;
  &nbsp;
  # Create __init__.py files
   
; Create __init__.py files
  type nul > pipeline\__init__.py
  type nul > pipeline\__init__.py
  type nul > speak_specs\__init__.py
  type nul > speak_specs\__init__.py
Line 41: Line 44:


== Development Workflow ==
== Development Workflow ==
# Always work from project root with venv active
; Always work from project root with venv active
  # After creating new modules:
 
 
=== First: Activate Virtual Environment ===
; If using Windows CMD:
  .\venv\Scripts\activate
 
; If using Windows PowerShell:
.\venv\Scripts\Activate.ps1
 
=== Verify activation - should see: ===
(venv) C:\Users\donem\Desktop\projects\python\xenotools>
 
=== Then: Install/Update Project ===
  pip install -e .
  pip install -e .
&nbsp;
 
# Run tests from project root:
=== Finally: Run Tests ===
  python pipeline/test_config.py
  python pipeline/test_config.py
  python pipeline/test_data_reader.py
  python pipeline/test_data_reader.py
  python pipeline/test_visualizer.py
  python pipeline/test_visualizer.py
== When Done: Deactivate Virtual Environment ==
deactivate


== Common Issues & Solutions ==
== Common Issues & Solutions ==

Latest revision as of 14:45, 2 November 2024

SymbioPoietrix ∞  XenoEngineer's Guide to Quantum-Semantic Knowledge Evolution ∞  Quantum-Semantic Symbiopoiesis Initialization ∞  Xenotools Workflow Setup ∞  Quantum Test Data Generation Prompt ∞ 

workflow.readme.txt

XenoTools Quantum-Semantic Development Environment Setup
Created by: XenoEngineer & Claude
Last Updated: 2024-11-02

Environment Setup

Navigate to project root
cd C:\Users\donem\Desktop\projects\python\xenotools

Create/activate virtual environment (if not exists)
python -m venv venv
.\venv\Scripts\activate
 
Verify activation - should see (venv) in prompt
(venv) C:\Users\donem\Desktop\projects\python\xenotools>


Dependencies Installation

Install all required packages
pip install anthropic python-dotenv pyyaml pandas numpy matplotlib seaborn
 
Verify package installation
pip list

Project Structure Creation

Ensure directories exist
mkdir pipeline speak_specs mind_models
mkdir test_data test_output
 

Create __init__.py files
type nul > pipeline\__init__.py
type nul > speak_specs\__init__.py
type nul > mind_models\__init__.py

Development Workflow

Always work from project root with venv active


First: Activate Virtual Environment

If using Windows CMD
.\venv\Scripts\activate
If using Windows PowerShell
.\venv\Scripts\Activate.ps1

Verify activation - should see:

(venv) C:\Users\donem\Desktop\projects\python\xenotools>

Then: Install/Update Project

pip install -e .

Finally: Run Tests

python pipeline/test_config.py
python pipeline/test_data_reader.py
python pipeline/test_visualizer.py

When Done: Deactivate Virtual Environment

deactivate

Common Issues & Solutions

  • If module not found: Check working directory and venv activation
  • If import errors: Verify pip install -e . after new modules
  • If file not found: Use absolute paths from project root
  • If test data missing: Create test_data directory first

Best Practices

  • Run all commands from project root
  • Keep venv active during development
  • Use relative imports within modules
  • Clean test data after runs
  • Update setup.py when adding dependencies

File Naming Conventions

  • Modules: lowercase with underscores
  • Classes: CamelCase
  • Test files: test_modulename.py
  • Config files: lowercase with dots

Git Commands (if using version control)

git add .
git commit -m "Meaningful commit message"
git push origin main