rapid7

metasploit-framework: Build and Run Security Testing Modules

Metasploit Framework is a Ruby-based platform for security testing, centered on the msfconsole interface and a module API. It suits security practitioners who need a documented framework for running and developing modules on Linux or macOS.

Stars
39.3k
Forks
15k
Last commit
1 day ago
Contributors
100+
Releases, 12 months
0

Our take

Activeregular commits

Health score

60/100

How it is scored
Activity
53
Community
92
Issues
49
Pull requests
46
  • Merges more pull requests than 88% of the projects we track
  • More contributors than 78% of the projects we track
  • Slower to merge pull requests than 97% of the projects we track

Metasploit is an established, actively maintained Ruby security framework with broad contributor participation, though it has not published a release in the past year.

Good fit if

  • You need a Ruby-based security-testing framework with msfconsole and a module API.
  • Your team can use Linux, macOS, or Kali and follow the project's setup documentation.
  • You want a project with regular recent commits and contributions from many contributors.

Look elsewhere if

  • You require a release published within the past year.
  • Your environment cannot run Ruby or use the listed Linux, macOS, or Kali installation paths.
  • Your licensing review requires a definitive license declaration from repository metadata; check COPYING before adopting it.
All health signals
Last commit2026-11-07 (1 day ago)
Commits, last 90 days100+
Releases, last 12 months0
Contributors100+ (top contributor: 17% of commits)
Issues closed, last 90 days8+ (typically closed in 14 days)
Pull requests merged, last 90 days83 (typically merged in 16 days)
Project age15 years

Checked on 2026-11-09 with the GitHub API.

Project history

Daily GitHub snapshots since Nov 9, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

39,340

Forks

15,007

More snapshots will appear as the daily collection continues.

Overview

Metasploit Framework is a Ruby-based platform for security testing, with msfconsole as its primary interface and an API for writing modules. It provides a framework for practitioners who need to use or develop security-testing modules rather than a single-purpose scanning tool.

The project recommends its installers for Linux and macOS, and notes that Metasploit is pre-installed with Kali. Documentation covers usage, development setup, and the module API.

Key Features

  • msfconsole provides the primary interface for interacting with the framework.
  • An API and documentation support writing Metasploit modules.
  • Official installers are available for Linux and macOS, with Kali also listed as a pre-installed option.
  • Usage guides and a development setup guide are maintained in the documentation.
  • Nightly installers provide access to the latest version.
  • GitHub Issues, Discussions, and Slack are listed as project support and communication channels.

Use Cases

  • Security practitioners can use msfconsole to work with Metasploit during authorized security testing.
  • Developers can build modules for the framework using its API documentation and Ruby development environment.
  • Teams using Kali can start with its pre-installed Metasploit, while Linux and macOS users can use the official installers.
  • Contributors can set up the development environment and submit changes through the project's pull request process.

What you need

Detected in the repository

  • Ruby (from Gemfile)
  • A Dockerfile, so it can run in a container; a Compose file sets up the related services
  • A test suite and automated checks on GitHub Actions

Getting Started

Install using the official installer instructions, then start msfconsole. See the Using Metasploit guide for details.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Alternatives

  • Sn1per: Sn1per combines reconnaissance, scanning, exploitation, and reporting in a shell-based workspace, while Metasploit centers on an extensible Ruby module framework.
  • Nettacker: Nettacker focuses on automated information gathering and modular network and web scans, while Metasploit centers on modules for security testing and exploitation.
ProjectLanguageLicenseStarsStatus
metasploit-frameworkRuby–39.3kActive
Sn1perShell–11.5kQuiet
NettackerPythonApache-2.05.7kActive

Considerations

The project is active, with regular commits and contributions spread across many contributors, but the measured data shows no release in the past year. The README describes the software as released under a BSD-style license, while the repository metadata does not assert a license; review the COPYING file for licensing terms. Development setup requires Ruby, and the README points to a dedicated guide rather than providing a one-command manual setup.

Found this useful?

Share it with someone who would like metasploit-framework.

Comparisons