Data Management.md - himent12/FlashGenie GitHub Wiki

Access Control

Manage access to your data:

# Set up user authentication
python -m flashgenie auth setup \
  --username "user" \
  --password "secure-password" \
  --require-auth-for "export,delete,share"

# Create access profiles
python -m flashgenie auth create-profile "readonly" \
  --permissions "read,quiz" \
  --no-export

📝 Data Transformation

Content Normalization

Normalize card content:

# Normalize text formatting
python -m flashgenie normalize "Spanish" \
  --fix-capitalization \
  --remove-extra-whitespace \
  --standardize-punctuation

# Normalize card structure
python -m flashgenie normalize-structure "Biology" \
  --question-pattern "What is {term}?" \
  --answer-min-length 10

Content Enrichment

Enrich card content:

# Add examples to cards
python -m flashgenie enrich "Language" \
  --add-examples 1 \
  --add-context \
  --generate-mnemonics

# Add media to cards
python -m flashgenie add-media "Biology" \
  --search-images \
  --safe-search on \
  --max-per-card 1

Content Splitting

Split complex content:

# Split long answers
python -m flashgenie split-content "History" \
  --max-answer-length 200 \
  --create-connections \
  --preserve-context

🔄 Import/Export File Formats

Supported Import Formats

FlashGenie supports these import formats:

Format	Extension	Description	Example
CSV	.csv	Comma-separated values	question,answer
TSV	.tsv	Tab-separated values	question\tanswer
TXT	.txt	Plain text with separators	question::answer
JSON	.json	JSON structured data	{"q": "question", "a": "answer"}
Markdown	.md	Markdown with Q/A formatting	# Q: question\nA: answer
XLSX	.xlsx	Excel spreadsheet	Columns for Q/A
Anki	.apkg	Anki package	Anki export file
Quizlet	n/a	Quizlet API import	Via set ID

Supported Export Formats

FlashGenie supports these export formats:

Format	Extension	Description	Features
CSV	.csv	Comma-separated values	Basic, portable
JSON	.json	JSON structured data	Complete metadata
Markdown	.md	Markdown formatted	Human-readable
PDF	.pdf	Printable cards	Print-ready
XLSX	.xlsx	Excel spreadsheet	Filterable
HTML	.html	Web page	Interactive
Anki	.apkg	Anki package	Anki-compatible
Quizlet	n/a	Quizlet API export	Quizlet-compatible

🚀 Best Practices

Import Best Practices

1. Validate before import - Check file format and encoding
2. Start small - Test with a subset before large imports
3. Use descriptive deck names - Name decks clearly
4. Preserve metadata - Include tags and other metadata when possible
5. Post-import review - Verify imported content

Export Best Practices

1. Regular exports - Schedule regular exports as additional backups
2. Include metadata - Export with complete metadata
3. Use standard formats - Prefer portable formats like CSV/JSON
4. Document export settings - Note the settings used for exports
5. Verify exports - Check exported files for completeness

Backup Best Practices

1. 3-2-1 Rule - 3 copies, 2 different media, 1 off-site
2. Regular schedule - Automate regular backups
3. Test restores - Periodically test backup restoration
4. Version backups - Keep multiple backup versions
5. Encrypt sensitive data - Use encryption for private information

🚀 Next Steps

• Complete Command Reference - All CLI commands with examples
• Advanced Usage Patterns - Power-user techniques and workflows
• Customization Guide - Personalize your learning experience

---

FlashGenie v1.5.0 | Last updated: June 2025