Recruiters and technical hiring managers spend an average of six seconds scanning a GitHub profile before deciding whether to dig deeper. For AI engineers, that profile is more than a code storage space. It is the primary evidence of technical competence, problem-solving ability, and professional maturity. A well-crafted GitHub portfolio can open doors that a resume alone cannot touch.
Many candidates make the mistake of treating GitHub like a personal hard drive. They dump incomplete notebooks, fork repositories without meaningful contributions, and leave critical documentation blank. The result is a profile that signals disorganization rather than expertise. This article addresses that gap directly by providing concrete AI engineer project portfolio examples GitHub recruiters actually want to see, along with the structural principles that make each repository effective.
You will learn which project types demonstrate depth rather than breadth, how to document your work so non-technical stakeholders understand its value, and what common mistakes cause hiring managers to move on before reading a single line of code. Whether you are a recent graduate building your first portfolio or an experienced professional transitioning into artificial intelligence, these guidelines will help you present your capabilities with clarity and confidence.
Why an AI Engineer Portfolio on GitHub Matters

GitHub has evolved beyond a version control platform. It now functions as a living resume for technical professionals. For AI engineers, the stakes are particularly high because the work itself is abstract. Unlike a front-end developer who can point to a deployed website, an AI engineer’s output often consists of model weights, evaluation metrics, and data pipelines. These artifacts require deliberate presentation to be understood and appreciated.
A strong GitHub portfolio serves three distinct audiences simultaneously. Technical recruiters scan for keyword alignment and activity patterns. Engineering managers evaluate code quality, documentation habits, and architectural decision-making. Peers and potential collaborators assess whether your work is reproducible and well-structured enough to build upon. By designing repositories that address all three perspectives, you multiply the professional opportunities your portfolio generates.
The Shift Toward Portfolio-Based Hiring
Traditional technical interviews are expensive for companies and stressful for candidates. Many organizations now use portfolio reviews as an initial screening step before committing to a full interview loop. This trend accelerated as AI tools made it easier for candidates to generate plausible-sounding answers during live coding exercises. A GitHub history spanning months or years cannot be faked in the same way.
Hiring managers look for genuine engagement with the craft. Regular commits, thoughtful pull request descriptions, and incremental improvements to projects signal authentic interest. A single polished repository with clear documentation often carries more weight than a dozen abandoned side projects. The consistency of your contribution history tells a story about your work habits that no interview question can reveal.
What Recruiters Look For in AI Portfolios
Recruiters typically follow a scanning pattern when reviewing GitHub profiles. They check the contribution graph for consistent activity. They read the README files of pinned repositories to understand project scope. They note whether repositories include proper documentation, requirements files, and setup instructions. Projects that cannot be reproduced easily lose credibility regardless of their technical sophistication.
Specificity matters more than volume. A profile featuring three well-executed AI engineer project portfolio examples GitHub repositories with clear problem statements, documented methodologies, and measured results will outperform one with twenty generic tutorial implementations. Recruiters want to see that you can define a problem, design a solution, execute it competently, and communicate the outcome effectively.
The Open Source Contribution Advantage
Active contributions to established open source projects demonstrate a different category of skill than personal repositories. They prove you can read and understand existing codebases, follow contribution guidelines, communicate with maintainers, and write code that meets community standards. These abilities map directly to what employers need from engineers joining existing teams.
Even small contributions matter. Fixing documentation errors, adding test coverage, or resolving minor bugs shows initiative and collaborative ability. When recruiters see a mix of personal projects and open source contributions, they perceive a well-rounded engineer who can work independently and within established structures.
Read Also: Machine Learning Projects for AI Engineer Portfolio
Key Elements of a Strong AI Portfolio Repository

Every repository in your portfolio should function as a self-contained demonstration of professional capability. The technical content matters, but presentation and structure often determine whether that content gets examined at all. A repository that cannot be understood within five minutes of opening will rarely receive deeper attention from a busy hiring manager.
The most effective AI repositories share common structural elements that reduce cognitive load for reviewers. These elements signal that you understand how professional code is organized, documented, and shared. They also make your work accessible to non-specialist stakeholders who may influence hiring decisions.
Professional README Structure
The README file is the front door to your project. It should immediately answer four questions: what problem does this project solve, how does it solve it, what results did it achieve, and how can someone run it themselves. A clear project title, a concise description, and a visual overview such as an architecture diagram or demo screenshot set the stage effectively.
Below the overview, include a table of contents for longer READMEs, detailed setup instructions with exact dependency versions, and usage examples showing expected inputs and outputs. Every command listed should be tested and verified. Broken setup instructions are one of the fastest ways to lose reviewer confidence. A well-maintained README transforms a code dump into a professional deliverable.
Clean and Modular Code Organization
Repository structure communicates your architectural thinking before anyone reads a single function. Separate your code into logical modules: data processing, model definition, training scripts, evaluation, and utilities. Use clear file and folder naming conventions. Avoid monolithic notebooks that mix data loading, model training, and visualization into an undifferentiated stream of cells.
Configuration management deserves special attention. Externalize hyperparameters, file paths, and environment-specific settings into configuration files rather than hard-coding them. This practice demonstrates awareness of software engineering principles that matter in production environments. Include a dedicated requirements file with pinned dependency versions to ensure reproducibility.
Comprehensive Testing and Validation
Testing is often neglected in portfolio projects, which makes its presence especially impactful. Unit tests for data processing functions, integration tests for pipeline stages, and validation scripts that verify model outputs all signal professional maturity. You do not need complete test coverage, but demonstrating that you know how and what to test distinguishes your portfolio from the majority.
Include examples of how you validated your model’s performance beyond aggregate metrics. Show confusion matrices, per-class precision-recall curves, or error analysis samples. This depth of evaluation communicates that you understand the limitations of summary statistics and care about understanding where and why your models fail.
Reproducibility Through Containerization
Docker configurations and environment specification files show that you take reproducibility seriously. A Dockerfile that builds a working environment eliminates the “it works on my machine” problem that plagues many AI projects. Include clear instructions for building and running the container, along with any necessary volume mounts or environment variables.
For projects using GPU acceleration, specify CUDA version compatibility and provide alternatives for running on CPU when feasible. These practical considerations make your work accessible to reviewers who may not have access to specialized hardware. Reproducibility transforms a demonstration project into credible evidence of production-ready skills.
Read Also: Python AI Engineer Required Skills List | Complete Guide
Project Idea: Machine Learning Model from Scratch

Implementing machine learning algorithms from scratch signals deep understanding of the mathematical foundations that underpin modern AI systems. While production work relies on established libraries, the ability to build core algorithms without framework assistance demonstrates mastery that distinguishes strong candidates. This project type works particularly well for entry-level positions where theoretical knowledge compensates for limited industry experience.
Choose algorithms that align with the roles you are targeting. A candidate interested in natural language processing might implement word embedding techniques and basic recurrent networks. Someone focused on computer vision could build convolutional layers and backpropagation from numpy arrays. The specific algorithm matters less than the quality of your implementation and explanation.
Selecting the Right Algorithm
Start with algorithms that are complex enough to be impressive but well-documented enough to verify correctness. Linear regression from scratch adds little value because the implementation is trivial. A multi-layer perceptron with customizable architecture, activation functions, and optimization methods provides richer demonstration opportunities. Decision tree implementations with pruning and ensemble methods also work well.
Include comparisons against established library implementations to validate your work. Show that your model achieves comparable results to scikit-learn or PyTorch equivalents on standard benchmark datasets. This validation transforms your project from an academic exercise into evidence of implementation reliability.
Documenting Mathematical Derivations
The documentation for from-scratch projects should include the mathematical foundations of each component. Use LaTeX-formatted equations in your README or accompanying documentation to show the gradients, update rules, and objective functions. GitHub renders LaTeX natively in markdown files, making mathematical notation accessible to readers.
Explain the intuition behind each equation in plain language. A reviewer should understand not just what you implemented but why each mathematical step matters for the learning process. This explanatory depth demonstrates the communication skills that senior engineers need when collaborating with cross-functional teams.
Performance Benchmarking and Analysis
Benchmark your implementation against standard library versions on multiple dimensions: training time, prediction accuracy, memory usage, and convergence behavior. Present results in organized tables and learning curve plots. Discuss where your implementation matches library performance and where it diverges, with analysis of the likely causes.
This analytical approach transforms a coding exercise into a research-oriented investigation. It shows that you understand performance considerations beyond simply getting correct outputs. Engineering managers value this awareness because production AI systems must balance accuracy with computational efficiency.
Read Also: AI Engineer Career Path Without Degree: Full Guide
Project Idea: Natural Language Processing Application

Natural language processing projects resonate strongly with employers because text data appears in virtually every industry. Customer support automation, document classification, sentiment analysis, and information extraction all rely on NLP techniques. A well-executed NLP project demonstrates your ability to handle unstructured data and extract actionable insights, skills that transfer directly to business value.
The key to a standout NLP portfolio project is solving a specific, recognizable problem rather than applying techniques generically. A sentiment classifier trained on generic movie reviews teaches less than a system designed to analyze customer feedback for a particular product category or industry vertical. Specificity creates memorable projects.
End-to-End Text Classification System
Build a text classification pipeline that processes raw text through cleaning, tokenization, feature extraction, model training, and deployment. Use modern techniques such as transformer-based embeddings rather than relying solely on traditional bag-of-words approaches. Show the progression from simple baselines to sophisticated models with measured improvements at each stage.
Include handling of real-world text challenges: misspellings, slang, code-switching, and domain-specific terminology. These practical considerations demonstrate awareness that clean datasets are rare in production environments. Document your preprocessing decisions with justification for each step.
Fine-Tuning Large Language Models
Fine-tuning a pre-trained language model for a specific task shows you can work with modern AI infrastructure efficiently. Choose a task where off-the-shelf models perform poorly without adaptation. Legal document classification, medical text analysis, or technical support ticket routing all benefit from domain-specific fine-tuning.
Document your data preparation process thoroughly. Explain how you selected training examples, handled class imbalance, and validated model performance on representative test sets. Include considerations around model size selection, quantization, and inference optimization that demonstrate production awareness.
Building an Interactive Demo
Deploy your NLP model behind a simple web interface using Streamlit, Gradio, or FastAPI. An interactive demo allows reviewers to experience your work directly rather than reading about results. This experiential quality creates stronger impressions than static metrics alone.
Include example inputs that showcase your model’s capabilities and limitations honestly. A demo that acknowledges edge cases and failure modes builds more trust than one claiming perfect performance. Technical reviewers respect intellectual honesty and will probe for weaknesses regardless. Addressing them proactively demonstrates professional maturity.
Read Also: AI Engineer Interview Questions: Machine Learning Guide
Project Idea: Computer Vision and Image Recognition
Computer vision projects provide visually compelling portfolio material that non-technical stakeholders can appreciate immediately. The ability to show before-and-after examples, detection visualizations, and segmentation masks creates intuitive understanding of your work’s impact. This visual accessibility makes CV projects especially effective for initial recruiter screenings.
Focus on applications that solve practical problems rather than reimplementing standard benchmarks. Object detection for retail shelf monitoring, medical image analysis for anomaly detection, or document layout parsing for automated data entry all connect technical capability to business value. These connections help hiring managers envision your contributions to their organization.
Custom Object Detection Pipeline
Build an object detection system using a custom dataset you created or curated. The data collection and annotation process itself demonstrates initiative and understanding of the full ML lifecycle. Use modern architectures like YOLO or Detectron2, and document your training configuration choices with clear reasoning.
Show detection results on diverse test images, including challenging cases with occlusion, varied lighting, and unusual object orientations. Discuss where your model succeeds and where it struggles. This balanced assessment demonstrates scientific thinking that engineering leaders value highly.
Image Segmentation for Practical Applications
Semantic or instance segmentation projects showcase advanced computer vision skills. Medical image segmentation, satellite imagery analysis, or autonomous vehicle perception all provide rich project contexts. The technical complexity of pixel-level prediction signals capability with sophisticated model architectures and loss functions.
Visualize your segmentation results overlaying ground truth and predictions side by side. Include quantitative metrics such as IoU scores and Dice coefficients with class-level breakdowns. Analysis of per-class performance reveals where your model needs improvement and demonstrates thorough evaluation practices.
Data Augmentation and Robustness Testing
Computer vision models are sensitive to input variations that humans ignore. Demonstrate your understanding of this challenge by implementing comprehensive data augmentation pipelines and testing model robustness systematically. Show how performance changes under different lighting conditions, rotations, scales, and noise levels.
Document your augmentation strategy with visual examples of transformed inputs. Explain which augmentations helped and which hurt performance, with hypotheses about why. This analytical approach to data engineering shows sophistication beyond simply applying off-the-shelf techniques.
Read Also: How Long to Learn AI Engineering Full Stack? Timeline & Guide
Project Idea: End-to-End MLOps Pipeline
MLOps skills are among the most sought-after in the AI job market. Companies need engineers who can move models from notebooks to production reliably. An end-to-end pipeline project demonstrates capability across the entire machine learning lifecycle: data ingestion, validation, training, evaluation, deployment, and monitoring. This breadth signals readiness for production engineering roles.
The pipeline project does not need enterprise-scale infrastructure. A well-architected system using free-tier cloud services or local container orchestration communicates the same principles. The key is demonstrating automated workflows, proper error handling, and monitoring capabilities that distinguish production systems from experimental code.
Automated Model Training Workflow
Design a training pipeline triggered by data updates or scheduled retraining intervals. Use GitHub Actions or similar CI/CD tools to automate training runs when new data becomes available. Include automated evaluation steps that compare new model performance against production baselines before deployment proceeds.
Document your pipeline architecture with clear diagrams showing data flow, processing stages, and decision points. Explain your choices around orchestration tools, experiment tracking, and model registry integration. These design decisions reveal architectural thinking that senior engineering roles require.
Model Serving and API Development
Deploy your trained model behind a REST API using FastAPI or Flask. Include request validation, error handling, and rate limiting that demonstrate awareness of production API concerns. Document your API with OpenAPI specifications and provide example requests and responses for common use cases.
Containerize your serving infrastructure with Docker and provide docker-compose configurations for multi-service setups. Include health check endpoints and basic monitoring that would allow operations teams to maintain your service. These practical considerations bridge the gap between data science experimentation and software engineering reliability.
Monitoring and Model Drift Detection
Implement basic monitoring that tracks prediction distributions, latency, and error rates over time. Set up alerts for significant deviations that might indicate model drift or infrastructure problems. This operational awareness distinguishes candidates who understand that model deployment is the beginning of ongoing responsibility, not the end of a project.
Include a dashboard built with Streamlit or Grafana that visualizes key metrics. Explain what thresholds would trigger model retraining and how you would investigate performance degradation. These forward-looking considerations demonstrate the mindset of an engineer who builds systems, not just models.
Read Also: Transition from Software Engineer to AI Engineer: Roadmap
Project Idea: Reinforcement Learning Agent
Reinforcement learning projects demonstrate capability with a specialized and mathematically demanding subfield of AI. RL practitioners are relatively rare in the job market, making strong RL portfolios memorable to recruiters hiring for robotics, game AI, recommendation systems, and autonomous decision-making roles. Even for positions not primarily focused on RL, the project signals comfort with advanced optimization concepts.
Choose environments with visual appeal that allow reviewers to understand agent behavior intuitively. Classic control problems, Atari games, or custom grid-world environments all provide this accessibility. The ability to show learning progress through video or animated visualizations creates compelling portfolio material.
Custom Environment Design
Building a custom environment demonstrates deeper understanding than using only pre-packaged gym environments. Design a simple game, simulation, or optimization scenario that requires non-trivial decision-making. Implement it using the OpenAI Gym interface to show familiarity with standard RL APIs.
Document your environment’s state space, action space, and reward function design with clear rationale. Explain how your reward shaping encourages desired behaviors and what pitfalls you encountered. Reward function design is one of the hardest aspects of applied RL, and thoughtful discussion of this challenge impresses knowledgeable reviewers.
Algorithm Implementation and Comparison
Implement and compare multiple RL algorithms on your environment. Show the progression from simple methods like Q-learning to advanced approaches such as PPO or SAC. Present learning curves, sample efficiency comparisons, and final performance metrics in clear visualizations.
Discuss the practical trade-offs you observed: sample efficiency versus wall-clock time, stability versus asymptotic performance, simplicity versus capability. These comparative insights demonstrate the nuanced understanding that comes from hands-on experimentation rather than theoretical study alone.
Visualization of Learned Policies
Create video recordings or animated GIFs showing your agent’s behavior at different stages of training. Early random exploration contrasted with skilled later behavior tells a compelling story about learning progress. Include visualizations of value functions or policy distributions where applicable to provide deeper insight into agent decision-making.
Visual content is highly shareable and creates strong impressions during quick portfolio scans. A 30-second video of an agent solving a task can communicate more effectively than paragraphs of performance metrics. Invest time in creating polished visualizations that represent your work professionally.
Read Also: Roadmap to Becoming an AI Engineer from Scratch
Project Idea: Generative AI and Large Language Model Integration
Generative AI projects tap into the most visible trend in artificial intelligence. Employers across industries are seeking engineers who can integrate large language models into practical applications responsibly. A portfolio project demonstrating LLM integration with proper evaluation, safety considerations, and practical utility positions you directly in this high-demand area.
Avoid building yet another ChatGPT wrapper without added value. Instead, create systems that combine LLM capabilities with structured data, domain-specific knowledge, or multi-step reasoning workflows. The differentiation comes from the engineering around the model, not just API calls to existing services.
Retrieval-Augmented Generation System
Build a RAG system that answers questions using a specific knowledge base. This architecture combines embedding-based retrieval with generative response synthesis, demonstrating skills with both vector search and prompt engineering. Choose a domain with publicly available documents such as research papers, technical manuals, or legal texts.
Implement and evaluate different chunking strategies, embedding models, and retrieval approaches. Show how these choices affect answer quality with quantitative metrics and qualitative examples. Include failure analysis that honestly examines when and why the system produces incorrect or incomplete responses.
Prompt Engineering and Evaluation Framework
Design a systematic evaluation framework for comparing prompt strategies. Define clear task success criteria, create a diverse test set covering edge cases, and report results across multiple prompt variations. This structured approach to prompt engineering demonstrates scientific rigor in an area where ad-hoc approaches are common.
Document your prompt design process with the reasoning behind each element: system messages, few-shot examples, output format specifications, and chain-of-thought instructions. Explain which prompt components had the largest impact on performance. This analytical treatment elevates prompt engineering from trial-and-error to systematic methodology.
Safety and Responsible AI Considerations
Implement content filtering, output validation, and usage monitoring appropriate to your application. Document your approach to handling harmful requests, biased outputs, and factual errors. These considerations are no longer optional for professional AI portfolios. Companies actively seek engineers who understand responsible AI practices.
Include a model card or similar documentation following established frameworks for AI transparency. Describe your model’s intended use, limitations, training data characteristics, and evaluation results. This documentation practice aligns with emerging industry standards and regulatory expectations.
Read Also: Prerequisites for AI Engineer Role: A Complete Guide
How to Document and Present Your GitHub Portfolio
Documentation quality often determines whether technical work receives appropriate recognition. The most sophisticated model implementation loses impact if reviewers cannot understand what it does or how to run it. Investing time in documentation and presentation amplifies the value of your technical work by making it accessible to a broader audience.
Good documentation follows a predictable structure that readers can navigate intuitively. It answers questions before they arise and provides clear pathways for different reader personas. A recruiter needs different information than a technical evaluator, and your repository should serve both effectively.
Writing Effective Project Descriptions
Every project should begin with a one-paragraph description that any reader can understand. State the problem, your approach, and the key result in plain language. Avoid jargon in this opening paragraph. Technical depth belongs in later sections for readers who choose to dive deeper.
Follow this accessible summary with increasingly detailed technical information. Use clear section headings that guide readers to relevant content. A well-structured README allows different readers to extract the information they need without reading everything. This respect for reader time signals professional communication skills.
Creating Visual Project Summaries
Include architecture diagrams, result visualizations, and demo screenshots near the top of your README. Visual elements communicate project scope and outcomes faster than text alone. Tools like draw.io, Excalidraw, or Mermaid diagrams can create professional visuals without design expertise.
For AI engineer project portfolio examples GitHub repositories, consider including animated demonstrations of model outputs. A short GIF showing object detection results or a chatbot interaction creates immediate understanding of your project’s capabilities. These visual elements make your portfolio memorable during rapid screening processes.
Maintaining a Professional GitHub Profile
Your GitHub profile page is the container for all your project repositories. Customize your profile README to introduce yourself professionally. Include your technical focus areas, links to deployed projects, and brief information about your background and interests. Pin your strongest repositories so they appear prominently.
Keep your contribution history active with regular commits. Long gaps without activity raise questions, even if you have legitimate reasons. Contribute to open source projects, update documentation, or work on small improvements to maintain visible engagement. The contribution graph is often the first thing visitors notice.
Read Also: AI Engineer Certifications for Career Advancement
Promoting Your AI Portfolio to Recruiters
Building an excellent portfolio is necessary but not sufficient. You must also ensure that the right people see it. Strategic promotion connects your work with hiring opportunities and multiplies the return on your portfolio investment. The most effective promotion strategies feel helpful and professional rather than self-promotional.
Timing matters in portfolio promotion. Share projects when they are complete and polished, not when they are works in progress. A single well-promoted project release generates more attention than frequent posts about half-finished work. Quality beats frequency in professional portfolio marketing.
Linking Portfolio to Job Applications
Include direct links to relevant repositories in your resume and cover letters. Do not simply list your GitHub profile URL. Select one or two projects most relevant to each application and link them specifically. In your cover letter, briefly explain why each project demonstrates skills valuable for the target role.
Customize which projects you highlight based on the job description. An NLP role should feature your text analysis projects prominently. An MLOps position should lead with your pipeline and deployment work. This targeted approach shows you understand the role requirements and have directly relevant experience.
Sharing Projects on Professional Networks
Write LinkedIn posts about your projects that focus on lessons learned and technical decisions rather than self-promotion. Share insights about challenges you overcame, design choices you made, and results that surprised you. Educational content attracts more engagement than announcements and positions you as a thoughtful practitioner.
Engage with others who comment on your posts thoughtfully. Answer questions thoroughly and acknowledge feedback graciously. These interactions demonstrate collaboration skills and technical communication ability that employers value alongside coding competence.
Preparing for Portfolio-Based Interviews
Many technical interviews now include portfolio review segments where you present and discuss your projects. Prepare concise walkthroughs of two or three repositories covering motivation, approach, results, and lessons learned. Practice explaining technical decisions clearly and admitting what you would do differently with hindsight.
Anticipate questions about trade-offs, alternative approaches, and scaling considerations. Interviewers want to understand your decision-making process, not just your final results. Being able to discuss rejected approaches and their relative merits demonstrates the engineering judgment that distinguishes senior candidates.
Read Also: How Long to Become an AI Engineer? Your [apc_current_year] Guide
Conclusion
A compelling GitHub portfolio transforms abstract AI skills into concrete evidence of professional capability. The AI engineer project portfolio examples GitHub repositories that attract recruiter attention share common qualities: clear problem definitions, well-structured code, thorough documentation, and honest evaluation of results. These qualities signal the engineering maturity that employers seek across every AI role and experience level.
Start by selecting two or three project types from this guide that align with your target roles. Focus on quality and completion rather than quantity. Each repository should tell a complete story from problem identification through solution delivery, with documentation that serves both technical and non-technical readers. Update your profile regularly and maintain visible engagement through commits and contributions.
Your portfolio is an evolving asset that grows with your career. Revisit older projects periodically to update dependencies, improve documentation, and reflect your current capabilities. A well-maintained portfolio demonstrates sustained professional engagement and continuous learning. These signals matter as much as the technical content itself when hiring managers evaluate candidates for AI engineering positions.
FAQ
Quality matters far more than quantity. Three to five well-executed projects with thorough documentation outperform a dozen incomplete or poorly documented repositories. Focus on depth. Each project should demonstrate multiple skills and include complete documentation, testing, and reproducible environments. A smaller number of polished projects signals professionalism more effectively than a large collection of unfinished experiments.
Deployment adds value but is not mandatory for every project. Deploy one or two projects that benefit most from interactive demonstration, such as NLP applications or computer vision systems. For infrastructure-focused projects like MLOps pipelines, the code architecture and documentation matter more than a running instance. Prioritize deployment for projects where direct interaction helps reviewers understand your work's impact.
Group projects are valuable when you clearly describe your specific contributions. Include a section in the README or a CONTRIBUTORS file that specifies which components you built or led. Avoid claiming credit for teammates' work. Recruiters value collaboration experience, but they need to evaluate your individual capabilities. Honest attribution of contributions builds trust.
Open source contributions and personal projects serve complementary roles in a portfolio. Personal projects demonstrate your ability to design and execute independently from concept to completion. Open source contributions show you can collaborate within existing codebases, follow community standards, and communicate with maintainers. A balanced portfolio includes both, but the ratio depends on your career stage and target roles.
The most damaging mistakes include incomplete README files, broken setup instructions, hard-coded paths that prevent reproducibility, and missing documentation for data sources and preprocessing steps. Avoid uploading Jupyter notebooks without explanation or context. Never claim results you cannot reproduce or attribute to others' work. Address these fundamentals before worrying about advanced portfolio features. Technical reviewers will forgive simpler projects executed well more readily than ambitious projects executed poorly.
