+╔══════════════════════════════════════════════════════════════════════════╗ +║ __ __ _____ ____ _____ _____ ___ ____ _____ _ _ _____ ║ +║ \ \ / /|_ _| __ ) | ____| / ____|/ _ \| _ \|_ _| \ | |/ ____| ║ +║ \ V / | | | _ \ | _| | | | | | | | | | | | | \| | | __ ║ +║ | | | | | |_) || |___ | |____| |_| | |_| | | | | |\ | |__| | ║ +║ |_| |___||____/ |_____| \_____|\___/|____/ |___| |_| \_|\_____| ║ +║ ║ +║ Programming with Natural Language for Human Rights ║ +╚══════════════════════════════════════════════════════════════════════════╝ ++ + + + + + +
+ WELCOME: In January 2024, Andrej Karpathy tweeted that "The hottest new programming language is English" - and pinned it to his profile. In this course, you'll learn how to leverage natural language to build powerful tools for human rights work - no computer science degree required. If you can describe what you want, you can build it. But be prepared to leave your comfort zone and dive into the basics of how computers process text.
+ AUTHOR: Łukasz Szoszkiewicz | Adam Mickiewicz University
+
+ We're standing on what Ethan Mollick calls the "jagged technological frontier" - + AI capabilities are uneven, excelling in unexpected areas while failing in others. + As human rights experts, we must experiment to discover where and how LLMs + can be integrated into our work. No one will do it for us. +
++ + 📖 Read: "Centaurs and Cyborgs on the Jagged Frontier" by Ethan Mollick + +
+DEFINITION:
+Natural Language Processing (NLP) is a field of artificial intelligence that enables computers
+ to understand, interpret, and generate human language. It's the bridge between human communication
+ and machine computation.
+ Key NLP tasks include:
+ • Search: Find relevant documents from large collections
+ • Classification: Categorize documents by topic, sentiment, or type
+ • Extraction: Pull out specific information (names, dates, concepts)
+ • Analysis: Discover patterns and trends in text data
+ • Summarization: Condense long documents into key points
+
DEFINITION:
+Vibe-coding is programming through natural language conversation with AI assistants. + Instead of writing code syntax, you describe what you want to build in plain English (or any language!).
+ +THE PARADIGM SHIFT:
+-
+
- ✓ Focus on ideas and outcomes, not syntax +
- ✓ Iterate rapidly through conversation +
- ✓ Learn "on demand" - depth-wise, not breadth-wise +
- ✓ Accessible to domain experts without CS degrees +
{
+ "advantages": {
+ "accessibility": "Opens programming to non-technical experts",
+ "speed": "Rapid prototyping and iteration",
+ "focus": "Concentrate on solving problems, not syntax",
+ "learning": "Learn programming concepts as needed"
+ },
+ "limitations": {
+ "control": "Less fine-grained control over implementation",
+ "debugging": "Harder to understand generated code deeply",
+ "dependency": "Reliant on AI capabilities - need to leverage domain expertise",
+ "optimization": "May not produce the most efficient code"
+ },
+ "read_more": {
+ "link": "https://www.datacamp.com/blog/vibe-coding"
+ }
+}
+ + Vibe-coding shines for simple, useful tools: a document search engine, + a lightweight analytics dashboard, or a short report generator. + Human rights experts often miss exactly these basics: decision/document search, filtering, and XLSX export. + Build step by step and shift towards your own code changes as you learn. + Over-ambitious first projects often end like this: +
+
+ How to become expert at thing:
+-
+
- Iteratively take on concrete projects and accomplish them depth wise, learning "on demand" +
- Teach/summarize everything you learn in your own words +
- Only compare yourself to younger you, never to others +
+ "LLMs are the new operating system - Software 3.0"
+ Watch: Software Is Changing (Again)
+
+ Writing code in Google Colab + and implementing the data analysis process ourselves (extraction, cleaning, text classification) provides: +
+-
+
- Provides greater control over the analysis process than uploading PDFs to an AI assistant +
- Full oversight over each step of the process +
- Greater transparency and explainability of our methodology +
- Reproducible research that others can verify and build upon +
+ 💡 To start: Go to colab.research.google.com, + sign in with Gmail (create a new account if needed), and click "New Notebook". + It's the fastest way to start coding - no installation required! +
+
+ Human rights work is fundamentally about text: treaties, reports, legal documents, testimonies.
+ Even basic NLP techniques can be gamechangers for human rights work:
+
-
+
- Transform collection of documents into searchable databases +
- Find patterns invisible to human reading (trends across decades of reports) +
- Quantify arguments with data (e.g., "Internet access" mentioned 27 times in 2024 reports - see example) +
- Build tools like General Comments Database +
- Democratize access to legal information +
+
Read about promises and pitfalls of NLP and AI in judiciary in the recent report of the SR on Independence of Judges and Lawyers (A/80/169)
+ + + +
+ How machine learning helps advance access to human rights information
+
+ HURIDOCS is using machine learning to facilitate text classification for the UPR Info.
+
+
🔧 DAY 1: Basics of Natural Language Processing
+-
+
- + + + +
- + + + +
- + + + +
- + + + +
- + + + +
- + + + +
- + + + +
+ macOS: +
+-
+
- Many Macs already have
python3
+ - Check in Terminal: +
python3 --version+
-
+
- If not found: install from python.org (Python 3.x installer for macOS) +
+ Windows: +
+-
+
- Install Python 3 from python.org +
- ⚠️ Important: During installation, tick "Add Python to PATH" +
🚀 DAY 2: Building Your Own App - Document Database
+-
+
- + + + +
- + + + +
- + + + +
- + + + +
- + + + +
- + + + +
+ Quick setup for testing your app: +
+-
+
- In one folder:
+
-
+
index.html(the html file you developed yesterday)
+ ccpr.json(dataset that you already have)
+
+ - In terminal in this folder: +
# Python +python -m http.server 8000 --bind localhost +# or python3 -m http.server 8000 --bind localhost+
-
+
- Open in browser:
http://localhost:8000
+
Example prompt:
++"Create a complete web application for searching +UN treaty body documents with the following functions:+
+1. Paragraph-Level Extraction +- Extract the first 20 paragraphs from the UN document attached +- Each paragraph maintains its original numbering (1-20) +- Full text preservation with proper formatting + +2. Thematic Labeling System +- Each paragraph has been categorized with relevant UN human rights framework themes - come up with 6 most relevant. Display in the output why and how did you select and defined categories. + +3. Advanced Search Functionality +- Keyword Search: Find individual terms (e.g., "information," "speech") +- Thematic Filtering: Filter by specific human rights themes +- Highlight Results: Search terms highlighted in yellow +- Real-time Search: Instant results as you type + +4. User Interface +- Modern, responsive design similar to OHCHR style +- Live dashboard with stats about filtered documents - theme distribution, term frequency, and bigrams +- Glass morphism effects and professional appearance +- Color-coded theme tags for easy identification +- Paragraph numbering system for reference +- Intuitive copy text and citation function +- Mobile-friendly responsive layout" +
+Example output (Sonnet 4.5): Here's what you get (one prompt, zero tweaks!)
+
🚀 BEYOND GOOGLE COLAB: CLAUDE CODE & CODEX
+Once you're comfortable with vibe-coding basics, graduate to professional tools:
+ +Claude Code / Codex - The Difference:
+-
+
- ✓ Direct file access: Works with files on your computer +
- ✓ Complete applications: Creates entire folder structures automatically +
- ✓ Professional workflow: Proper file organization, paths, dependencies +
- ✓ Multi-file projects: Manages HTML, CSS, JS, Python together +
+ Claude Code/Codex creates the ENTIRE project structure - ready to be uploaded! +
#!/bin/bash + +echo "=== ESSENTIAL TOOLS ===" +echo "• Claude/Gemini - Your vibe-coding partner" +echo "• https://lmarena.ai/ - Free (limited) access to cutting-edge models" +echo "• https://colab.research.google.com - Free Python environment" +echo "• Dataset (CCPR): https://drive.google.com/drive/folders/1bw2NzG1FQhfcJQiOZdnVCK5ofn7ho6U1?usp=share_link" +echo "• UN Treaty Body Database: https://lszoszk.pythonanywhere.com" + +echo "=== TOOLS FOR THE NEXT LEVEL ===" +echo "• GitHub - Code sharing and version control" +echo "• Hugging Face - Open source datasets and models" +echo "• PyCharm - Coding environment with educational license" +echo "• PythonAnywhere - Easy web app deployment" + +echo "" +echo "=== ADDITIONAL MATERIALS ===" +echo "• Karpathy: Software Is Changing (Again)" +echo "• Karpathy: We’re summoning ghosts, not building animals [podcast]" +echo "• Mollick: Centaurs and Cyborgs" +echo "• Mollick: The Cybernetic Teammate" +echo "• Marker: https://github.com/datalab-to/marker" +echo "• HURIDOCS OCR repo: https://github.com/huridocs" +echo "• DataCamp: What is Vibe Coding? [Pros and Cons]" +echo "• SICSS @ AMU Law: https://sicss.io/2025/amu-law/" + +echo "" +echo "=== EXAMPLE PROJECTS ===" +echo "• UN Treaty Body Database" +echo "• Polish Constitutional Court Explorer" +echo "• Your future projects here!" ++
+ Learning through building: I won't teach you programming theory. + Instead, you'll build real tools for human rights work and learn what you need along the way. +
++ Effort over entertainment: This course requires effort. + It's not meant to be easy, but it will be rewarding when you build something that helps real people. +
++ Compare to yourself: Don't worry about others' progress. + Focus on what you couldn't do yesterday but can do today. +
+#!/bin/bash + +echo "Starting your vibe-coding journey..." +echo "" +echo "Remember:" +echo " [✓] You don't need to be a programmer" +echo " [✓] You already have domain expertise" +echo " [✓] AI will be your coding partner" +echo " [✓] You'll build something meaningful" +echo "" +echo "The best time to start was yesterday." +echo "The second best time is now." +echo "" +read -p "Press [ENTER] to begin your transformation..." +echo "" +echo "Welcome to the future of human rights tech! 🚀" ++
AUTHOR:
+Łukasz Szoszkiewicz
+Adam Mickiewicz University, Poznań
+ +QUESTIONS?
+Bring them to class - the best questions come from confusion!
+Remember: There are no stupid questions, only missed opportunities to learn.
+