@saibolla/ada 0.1.2

package/skills/paper-2-web/references/paper2poster.md

@@ -0,0 +1,346 @@
+# Paper2Poster: Academic Poster Generation
+
+## Overview
+
+Paper2Poster automatically generates professional academic posters from research papers. The system extracts key content, designs visually appealing layouts, and creates print-ready posters suitable for conferences, symposiums, and academic presentations.
+
+## Core Capabilities
+
+### 1. Content Extraction
+- Identifies key findings and contributions
+- Extracts important figures and tables
+- Summarizes methodology
+- Highlights results and conclusions
+- Preserves citations and references
+
+### 2. Layout Design
+- Creates balanced, professional layouts
+- Optimizes content density and white space
+- Establishes clear visual hierarchy
+- Supports multiple poster sizes
+- Adapts to different content types
+
+### 3. Visual Design
+- Applies color schemes and branding
+- Optimizes typography for readability
+- Ensures figure quality and sizing
+- Creates cohesive visual identity
+- Maintains academic presentation standards
+
+## Usage
+
+### Basic Poster Generation
+
+```bash
+python pipeline_all.py \
+  --input-dir "path/to/papers" \
+  --output-dir "path/to/output" \
+  --model-choice 1 \
+  --generate-poster
+```
+
+### Custom Poster Dimensions
+
+```bash
+python pipeline_all.py \
+  --input-dir "path/to/papers" \
+  --output-dir "path/to/output" \
+  --model-choice 2 \
+  --generate-poster \
+  --poster-width-inches 60 \
+  --poster-height-inches 40
+```
+
+### Parameters
+
+**Basic Configuration:**
+- `--input-dir`: Directory containing paper files
+- `--output-dir`: Directory for generated posters
+- `--model-choice`: LLM model selection (1=GPT-4, 2=GPT-4.1)
+- `--generate-poster`: Enable poster generation
+
+**Poster Dimensions:**
+- `--poster-width-inches`: Width in inches (default: 48)
+- `--poster-height-inches`: Height in inches (default: 36)
+- `--poster-orientation`: Portrait or landscape (default: landscape)
+- `--poster-dpi`: Resolution in DPI (default: 300)
+
+**Design Options:**
+- `--poster-template`: Template style (default: modern)
+- `--color-scheme`: Color palette selection
+- `--institution-branding`: Include institution colors and logos
+- `--font-family`: Typography selection
+
+## Standard Poster Sizes
+
+### Conference Standard Sizes
+- **4' × 3'** (48" × 36"): Most common conference poster
+- **5' × 4'** (60" × 48"): Large format for major conferences
+- **3' × 4'** (36" × 48"): Portrait orientation for narrow spaces
+- **A0** (841mm × 1189mm): International standard
+- **A1** (594mm × 841mm): Compact conference poster
+
+### Custom Sizes
+The system supports any custom dimensions. Specify using:
+```bash
+--poster-width-inches [width] --poster-height-inches [height]
+```
+
+## Input Requirements
+
+### Supported Input Formats
+1. **LaTeX source** (preferred)
+   - Main `.tex` file with complete paper
+   - All figures and tables referenced
+   - Compiled successfully
+
+2. **PDF**
+   - High-quality PDF with embedded fonts
+   - Selectable text (not scanned)
+   - High-resolution figures
+
+### Required Content Elements
+- Title and authors
+- Abstract or summary
+- Methodology description
+- Key results
+- Conclusions
+- References (optional but recommended)
+
+### Recommended Assets
+- High-resolution figures (300 DPI minimum)
+- Vector graphics (PDF, SVG, EPS)
+- Institution logo
+- Author photos (optional)
+- QR codes for website/repo links
+
+## Output Structure
+
+```
+output/paper_name/poster/
+├── poster_final.pdf          # Print-ready poster
+├── poster_final.png          # High-res PNG version
+├── poster_preview.pdf        # Low-res preview
+├── poster_source/            # Source files
+│   ├── layout.pptx          # Editable PowerPoint
+│   ├── layout.svg           # Vector graphics
+│   └── layout.json          # Layout specification
+├── assets/                   # Extracted assets
+│   ├── figures/             # Poster figures
+│   ├── logos/               # Institution logos
+│   └── qrcodes/             # Generated QR codes
+└── metadata/
+    ├── design_spec.json     # Design specifications
+    └── content_map.json     # Content organization
+```
+
+## Poster Layout Sections
+
+### Standard Sections
+1. **Header**
+   - Title (large, prominent)
+   - Authors and affiliations
+   - Institution logos
+   - Conference information
+
+2. **Introduction/Background**
+   - Problem statement
+   - Research motivation
+   - Brief literature context
+
+3. **Methods**
+   - Experimental design
+   - Key procedures
+   - Important parameters
+   - Visual workflow diagram
+
+4. **Results**
+   - Key findings (largest section)
+   - Primary figures and tables
+   - Statistical summaries
+   - Visual data representations
+
+5. **Conclusions**
+   - Main takeaways
+   - Implications
+   - Future work
+
+6. **References & Contact**
+   - Selected key references
+   - Author contact information
+   - QR codes for paper/website
+   - Acknowledgments
+
+## Design Templates
+
+### Modern Template (Default)
+- Clean, minimalist design
+- Bold colors for headers
+- Ample white space
+- Modern typography
+- Focus on visual hierarchy
+
+### Academic Template
+- Traditional academic styling
+- Conservative color palette
+- Dense information layout
+- Classic serif typography
+- Standard section organization
+
+### Visual Template
+- Image-focused layout
+- Large figure displays
+- Minimal text density
+- Infographic elements
+- Story-driven flow
+
+### Technical Template
+- Equation-friendly layout
+- Code snippet support
+- Detailed methodology sections
+- Technical figure emphasis
+- Engineering/CS aesthetic
+
+## Color Schemes
+
+### Predefined Schemes
+- **Institutional**: Uses institution branding colors
+- **Professional**: Navy blue and gray palette
+- **Vibrant**: Bold, eye-catching colors
+- **Nature**: Green and earth tones
+- **Tech**: Modern blue and cyan
+- **Warm**: Orange and red accents
+- **Cool**: Blue and purple tones
+
+### Custom Color Schemes
+Specify custom colors in configuration:
+```json
+{
+  "primary": "#1E3A8A",
+  "secondary": "#3B82F6",
+  "accent": "#F59E0B",
+  "background": "#FFFFFF",
+  "text": "#1F2937"
+}
+```
+
+## Typography Options
+
+### Font Families
+- **Sans-serif** (default): Clean, modern, highly readable
+- **Serif**: Traditional academic appearance
+- **Mixed**: Serif for body, sans-serif for headers
+- **Monospace**: For code and technical content
+
+### Size Hierarchy
+- **Title**: 72-96pt
+- **Section headers**: 48-60pt
+- **Subsection headers**: 36-48pt
+- **Body text**: 24-32pt
+- **Captions**: 18-24pt
+- **References**: 16-20pt
+
+## Quality Assurance
+
+### Automated Checks
+- **Text readability**: Minimum font size verification
+- **Color contrast**: Accessibility compliance
+- **Figure quality**: Resolution and clarity checks
+- **Layout balance**: Content distribution analysis
+- **Branding consistency**: Logo and color verification
+
+### Manual Review Checklist
+1. ☐ All figures are high resolution and clear
+2. ☐ Text is readable from 3-6 feet away
+3. ☐ Color scheme is professional and consistent
+4. ☐ No text overlaps or layout issues
+5. ☐ Institution logos are correct and high quality
+6. ☐ QR codes work and link to correct URLs
+7. ☐ Author information is accurate
+8. ☐ Key findings are prominently displayed
+9. ☐ References are properly formatted
+10. ☐ File is correct size and resolution for printing
+
+## Print Preparation
+
+### File Specifications
+- **Format**: PDF/X-1a or PDF/X-4 for professional printing
+- **Resolution**: 300 DPI minimum, 600 DPI for fine details
+- **Color mode**: CMYK for print (system auto-converts from RGB)
+- **Bleed**: 0.125" bleed on all sides (automatically added)
+- **Fonts**: All fonts embedded in PDF
+
+### Printing Recommendations
+1. **Print shop**: Use professional poster printing service
+2. **Paper type**: Matte or satin finish for academic posters
+3. **Backing**: Foam core or rigid backing for stability
+4. **Protection**: Lamination optional but recommended
+5. **Test print**: Print A4/Letter size preview first
+
+### Budget Options
+- **Standard**: $50-100 for 4'×3' poster at professional shop
+- **Economy**: $20-40 for print-only (no mounting)
+- **Premium**: $150-300 for high-end materials and mounting
+- **DIY**: <$10 for multiple pages tiled and assembled
+
+## Advanced Features
+
+### QR Code Generation
+Automatically generates QR codes for:
+- Paper PDF or DOI
+- Project website
+- GitHub repository
+- Data repository
+- Author profiles (ORCID, Google Scholar)
+
+### Institution Branding
+When enabled:
+- Extracts institution from author affiliations
+- Searches for official logos (requires Google Search API)
+- Applies institution color schemes
+- Matches brand guidelines
+
+### Interactive Elements (Digital Posters)
+For digital display or virtual conferences:
+- Clickable links and references
+- Embedded videos in figures
+- Interactive data visualizations
+- Animated transitions
+
+## Best Practices
+
+### Content Optimization
+1. **Focus on key findings**: Poster should tell story at a glance
+2. **Limit text**: Use bullet points, avoid paragraphs
+3. **Prioritize visuals**: Figures should dominate the space
+4. **Clear flow**: Guide viewer through logical progression
+5. **Highlight contributions**: Make novelty obvious
+
+### Design Optimization
+1. **Use contrast**: Ensure text is easily readable
+2. **Maintain hierarchy**: Size indicates importance
+3. **Balance content**: Avoid crowding any section
+4. **Consistent styling**: Same fonts, colors throughout
+5. **White space**: Don't fill every inch
+
+### Figure Optimization
+1. **Large enough**: Minimum 6" width for main figures
+2. **High resolution**: 300 DPI minimum
+3. **Clear labels**: Axis labels, legends readable
+4. **Remove clutter**: Simplify for poster format
+5. **Use captions**: Brief, informative descriptions
+
+## Limitations
+
+- Complex equations may need manual adjustment for readability
+- Very long papers may require content prioritization
+- Custom branding requires manual specification or API access
+- Multi-language support limited to common languages
+- 3D visualizations may lose quality in 2D poster format
+
+## Integration with Other Components
+
+Combine Paper2Poster with:
+- **Paper2Web**: Use matching visual design and color scheme
+- **Paper2Video**: Create poster walk-through video
+- **AutoPR**: Generate social media graphics from poster

package/skills/paper-2-web/references/paper2video.md

@@ -0,0 +1,305 @@
+# Paper2Video: Presentation Video Generation
+
+## Overview
+
+Paper2Video generates presentation videos from LaTeX sources, transforming academic papers into engaging video presentations. The system processes papers through multiple specialized modules to create professional presentation videos complete with slides, narration, and optional talking-head video.
+
+## Core Components
+
+### 1. Slide Generation Module
+- Extracts key content from paper structure
+- Creates visually appealing presentation slides
+- Organizes content in logical flow
+- Includes figures, tables, and equations
+- Optimizes text density for readability
+
+### 2. Subtitle Generation Module
+- Generates natural presentation script
+- Synchronizes text with slide transitions
+- Creates speaker notes and timing
+- Supports multiple languages
+- Optimizes for speech synthesis
+
+### 3. Speech Synthesis Module
+- Converts subtitles to natural-sounding speech
+- Supports multiple voices and accents
+- Controls pacing and emphasis
+- Generates audio track for video
+- Handles technical terminology
+
+### 4. Cursor Movement Module
+- Simulates presenter cursor movements
+- Highlights key points on slides
+- Guides viewer attention
+- Creates natural presentation flow
+- Synchronizes with narration
+
+### 5. Talking-Head Video Generation (Optional)
+- Uses Hallo2 for realistic presenter video
+- Lip-syncs with generated audio
+- Requires reference image or video
+- GPU-intensive (NVIDIA A6000 48GB minimum)
+- Creates engaging presenter presence
+
+## Usage
+
+### Basic Video Generation (Without Talking-Head)
+
+```bash
+python pipeline_light.py \
+  --model_name_t gpt-4.1 \
+  --model_name_v gpt-4.1 \
+  --result_dir /path/to/output \
+  --paper_latex_root /path/to/paper
+```
+
+### Full Video Generation (With Talking-Head)
+
+```bash
+python pipeline_all.py \
+  --input-dir "path/to/papers" \
+  --output-dir "path/to/output" \
+  --model-choice 1 \
+  --enable-talking-head
+```
+
+### Parameters
+
+**Model Configuration:**
+- `--model_name_t`: Model for text/subtitle generation (default: gpt-4.1)
+- `--model_name_v`: Model for visual/slide generation (default: gpt-4.1)
+- `--model-choice`: Preset model configuration (1=GPT-4, 2=GPT-4.1)
+
+**Input/Output:**
+- `--paper_latex_root`: Root directory of LaTeX paper source
+- `--result_dir` or `--output-dir`: Output directory for generated videos
+- `--input-dir`: Directory containing multiple papers to process
+
+**Video Options:**
+- `--enable-talking-head`: Enable talking-head video generation (requires GPU)
+- `--video-duration`: Target video duration in seconds (default: auto-calculated)
+- `--slides-per-minute`: Control presentation pacing (default: 2-3)
+- `--voice`: Voice selection for speech synthesis
+
+**Quality Settings:**
+- `--video-resolution`: Output resolution (default: 1920x1080)
+- `--video-fps`: Frame rate (default: 30)
+- `--audio-quality`: Audio bitrate (default: 192kbps)
+
+## Input Requirements
+
+### LaTeX Source Structure
+```
+paper_directory/
+├── main.tex              # Main paper file
+├── sections/             # Section files (if split)
+│   ├── introduction.tex
+│   ├── methods.tex
+│   └── results.tex
+├── figures/              # Figure files
+│   ├── fig1.pdf
+│   ├── fig2.png
+│   └── ...
+├── tables/               # Table files
+└── bibliography.bib      # References
+```
+
+### Required Elements
+- Valid LaTeX source that compiles
+- Proper section structure (abstract, introduction, methods, results, conclusion)
+- High-quality figures (vector formats preferred)
+- Complete bibliography
+
+### Optional Elements
+- Author photos for talking-head generation
+- Custom slide templates
+- Background music or sound effects
+- Institution branding assets
+
+## Output Structure
+
+```
+output/paper_name/video/
+├── final_video.mp4           # Complete presentation video
+├── slides/                   # Generated slide images
+│   ├── slide_001.png
+│   ├── slide_002.png
+│   └── ...
+├── audio/                    # Audio components
+│   ├── narration.mp3         # Speech synthesis output
+│   └── background.mp3        # Optional background audio
+├── subtitles/                # Subtitle files
+│   ├── subtitles.srt         # Standard subtitle format
+│   └── subtitles.vtt         # WebVTT format
+├── script/                   # Presentation script
+│   ├── full_script.txt       # Complete narration text
+│   └── slide_notes.json      # Slide-by-slide notes
+└── metadata/                 # Video metadata
+    ├── timings.json          # Slide timing information
+    └── video_info.json       # Video properties
+```
+
+## Video Generation Process
+
+### Phase 1: Content Analysis
+1. Parse LaTeX source structure
+2. Extract key concepts and findings
+3. Identify important figures and equations
+4. Determine logical presentation flow
+
+### Phase 2: Slide Creation
+1. Design slide layouts based on content
+2. Allocate content across appropriate number of slides
+3. Incorporate figures and visual elements
+4. Apply consistent styling and branding
+
+### Phase 3: Script Generation
+1. Write natural presentation narration
+2. Time script sections to slides
+3. Add transitions and emphasis
+4. Optimize for speech synthesis
+
+### Phase 4: Audio Production
+1. Generate speech from script
+2. Add emphasis and pacing
+3. Include pauses for slide transitions
+4. Mix with optional background audio
+
+### Phase 5: Video Assembly
+1. Combine slides with timing information
+2. Synchronize audio track
+3. Add cursor movements and highlights
+4. Generate talking-head video (if enabled)
+5. Render final video file
+
+## Customization Options
+
+### Presentation Style
+- **Academic**: Formal, detailed, comprehensive
+- **Conference**: Focused on key findings, faster pace
+- **Public**: Simplified language, engaging storytelling
+- **Tutorial**: Step-by-step explanation, educational focus
+
+### Voice Configuration
+Available voice options (via speech synthesis):
+- Multiple languages and accents
+- Male/female voice selection
+- Speaking rate adjustment
+- Pitch and tone customization
+
+### Visual Themes
+- Institution branding colors
+- Conference template matching
+- Custom backgrounds and fonts
+- Dark mode presentations
+
+## Quality Assessment
+
+### Content Quality Metrics
+- **Completeness**: Coverage of paper content
+- **Clarity**: Explanation quality and coherence
+- **Flow**: Logical progression of ideas
+- **Engagement**: Visual appeal and pacing
+
+### Technical Quality Metrics
+- **Audio quality**: Speech clarity and naturalness
+- **Video quality**: Resolution and encoding
+- **Synchronization**: Audio-visual alignment
+- **Timing**: Appropriate slide duration
+
+## Advanced Features
+
+### Multi-Language Support
+- Generate presentations in multiple languages
+- Automatic translation of script
+- Language-appropriate voice selection
+- Cultural adaptation of presentation style
+
+### Talking-Head Generation with Hallo2
+Requires:
+- NVIDIA A6000 GPU (48GB minimum)
+- Reference image or short video of presenter
+- Additional processing time (2-3x longer)
+
+Benefits:
+- More engaging presentation
+- Professional presenter appearance
+- Natural gestures and expressions
+- Lip-sync accuracy
+
+### Interactive Elements
+- Embedded clickable links
+- Navigation menu
+- Chapter markers
+- Supplementary material links
+
+## Best Practices
+
+### Input Preparation
+1. **Clean LaTeX source**: Remove unnecessary comments and artifacts
+2. **High-quality figures**: Use vector formats when possible
+3. **Clear structure**: Well-organized sections and subsections
+4. **Complete content**: Include all necessary files and references
+
+### Model Selection
+- **Text generation (model_name_t)**: GPT-4.1 for best script quality
+- **Visual generation (model_name_v)**: GPT-4.1 for optimal slide design
+- For faster processing with acceptable quality: GPT-3.5-turbo
+
+### Video Optimization
+1. **Target duration**: 10-15 minutes for conference talks, 30-45 for detailed presentations
+2. **Pacing**: 2-3 slides per minute for technical content
+3. **Resolution**: 1920x1080 for standard, 3840x2160 for high-quality
+4. **Audio**: 192kbps minimum for clear speech
+
+### Quality Review
+Before finalizing:
+1. Watch entire video for content accuracy
+2. Check audio synchronization with slides
+3. Verify figure quality and readability
+4. Test subtitle accuracy and timing
+5. Review cursor movements for natural flow
+
+## Performance Considerations
+
+### Processing Time
+- **Without talking-head**: 10-30 minutes per paper (depending on length)
+- **With talking-head**: 30-120 minutes per paper
+- **Factors**: Paper length, figure count, model speed, GPU availability
+
+### Resource Requirements
+- **CPU**: Multi-core recommended for parallel processing
+- **RAM**: 16GB minimum, 32GB for large papers
+- **GPU**: Optional for standard, required for talking-head (A6000 48GB)
+- **Storage**: 1-5GB per video depending on length and quality
+
+## Troubleshooting
+
+### Common Issues
+
+**1. LaTeX parsing errors**
+- Ensure LaTeX source compiles successfully
+- Check for special packages or custom commands
+- Verify all referenced files are present
+
+**2. Speech synthesis problems**
+- Check audio quality settings
+- Verify text is properly formatted
+- Test with different voice options
+
+**3. Video rendering failures**
+- Check available disk space
+- Verify all dependencies are installed
+- Review error logs for specific issues
+
+**4. Talking-head generation errors**
+- Confirm GPU memory (48GB required)
+- Check CUDA drivers are up to date
+- Verify reference image quality and format
+
+## Integration with Other Components
+
+Combine Paper2Video with:
+- **Paper2Web**: Embed video in generated website
+- **Paper2Poster**: Use matching visual style
+- **AutoPR**: Create promotional clips from full video