Skip to content

docs: add dp1s#5192

Queued
njzjz wants to merge 1 commit intodeepmodeling:masterfrom
njzjz:dp1s
Queued

docs: add dp1s#5192
njzjz wants to merge 1 commit intodeepmodeling:masterfrom
njzjz:dp1s

Conversation

@njzjz
Copy link
Member

@njzjz njzjz commented Feb 4, 2026

Summary by CodeRabbit

  • Documentation
    • Added quick-start installation guide with one-command install option.
    • Enhanced README with installation examples and detailed project structure information.
    • Reorganized installation documentation with improved entry point.
    • Added new "dp1s" installation method option to bug report template.

Copilot AI review requested due to automatic review settings February 4, 2026 14:11
@github-actions github-actions bot added the Docs label Feb 4, 2026
@gemini-code-assist
Copy link

Summary of Changes

Hello @njzjz, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request streamlines the installation experience for DeePMD-kit by integrating a new '1s' installation method, 'dp1s'. The changes primarily involve updating user-facing documentation and an internal issue template to reflect and support this simplified installation approach, making it easier for new users to get started and for support teams to understand user environments.

Highlights

  • New Installation Method: Introduced 'dp1s' as a new, simplified installation method for DeePMD-kit, allowing for a quick setup via a single curl | bash command.
  • Documentation Updates: The README.md and doc/install/easy-install.md files have been updated to prominently feature the new 'dp1s' installation method, including the command snippet and a link to the dp1s repository for more details.
  • Issue Template Enhancement: The bug report issue template (.github/ISSUE_TEMPLATE/bug-report.yml) was updated to include 'dp1s' as an option for how users installed DeePMD-kit, aiding in better issue tracking and support.
Changelog
  • .github/ISSUE_TEMPLATE/bug-report.yml
    • Added 'dp1s' as a new option under the 'How did you install DeePMD-kit?' field.
  • README.md
    • Inserted a new section under 'Install and use DeePMD-kit' detailing the 'dp1s' installation command (curl -fsSL https://dp1s.deepmodeling.com | bash).
    • Added an example usage command dp after installation instructions.
    • Modified the existing link to online documentation to clarify it's for 'details and alternative installation methods'.
  • doc/install/easy-install.md
    • Added a new top-level section 'Install DeePMD-kit in 1s' with the 'dp1s' installation command.
    • Included a link to the dp1s repository for more options.
    • Removed the previous bulleted list of installation methods from the top of the document, implying the new 'dp1s' method is now the primary recommendation.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 4, 2026

📝 Walkthrough

Walkthrough

Added a new "dp1s" installation option to the bug report template and enhanced documentation with a quick-start curl-based installation snippet and consolidated installation guide. Updated README with quick-start instructions and expanded code structure details, and restructured installation documentation to prioritize the 1-second install entry point.

Changes

Cohort / File(s) Summary
Configuration & Templates
.github/ISSUE_TEMPLATE/bug-report.yml
Added "dp1s" option to installation-way dropdown in bug report template.
Documentation Updates
README.md, doc/install/easy-install.md
Added quick-start curl-based installation section and reference to dp1s repository. README enhanced with code structure directory listing. Installation guide reorganized to prioritize 1-second install entry point.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested labels

Docs

Suggested reviewers

  • wanghan-iapcm
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: add dp1s' directly and specifically describes the main change—adding documentation about dp1s, a new quick-install tool. It clearly summarizes the primary purpose of the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Important

Action Needed: IP Allowlist Update

If your organization protects your Git platform with IP whitelisting, please add the new CodeRabbit IP address to your allowlist:

  • 136.113.208.247/32 (new)
  • 34.170.211.100/32
  • 35.222.179.152/32

Reviews will stop working after February 8, 2026 if the new IP is not added to your allowlist.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds “dp1s” as a one-command installation path in the docs/README and makes it selectable in the bug report template.

Changes:

  • Document a dp1s-based “1-command” installer in doc/install/easy-install.md.
  • Update README.md install section to feature the dp1s command and add a minimal “try dp” step.
  • Add dp1s as an installation option in the bug report issue template.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File Description
doc/install/easy-install.md Adds a new top-level “Install DeePMD-kit in 1s” section with the dp1s install command and repo link.
README.md Replaces the install pointer with a dp1s quick-install snippet and a quick “dp” invocation.
.github/ISSUE_TEMPLATE/bug-report.yml Adds dp1s to installation-method dropdown options.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new one-second installation method (dp1s) for DeePMD-kit and updates the documentation accordingly. The changes are straightforward, but I've raised a medium-severity concern regarding the security of the curl | bash installation method. I've provided suggestions to add a security warning and improve the clarity of the installation instructions in both the README.md and doc/install/easy-install.md files.

@codecov
Copy link

codecov bot commented Feb 4, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.95%. Comparing base (8787b45) to head (7be2185).

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #5192   +/-   ##
=======================================
  Coverage   81.95%   81.95%           
=======================================
  Files         714      714           
  Lines       73441    73441           
  Branches     3616     3617    +1     
=======================================
+ Hits        60187    60188    +1     
  Misses      12091    12091           
+ Partials     1163     1162    -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@njzjz njzjz requested a review from wanghan-iapcm February 4, 2026 16:01
@wanghan-iapcm wanghan-iapcm added this pull request to the merge queue Feb 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants