![source{d} Community Edition (CE)](https://raw.githubusercontent.com/src-d/sourced-ce/master/docs/assets/sourced-community-edition.png)
source{d} Community Edition (CE) is the data platform for your software development life cycle.
Website • Documentation • Blog • Slack • Twitter
source{d} Community Edition (CE) helps you to manage all your code and engineering data in one place:
- Code Retrieval: Retrieve and store the git history of the code of your organization as a dataset.
- Analysis in/for any Language: Automatically identify languages, parse source code, and extract the pieces that matter in a language-agnostic way.
- History Analysis: Extract information from the evolution, commits, and metadata of your codebase and from GitHub, generating detailed reports and insights.
- Familiar APIs: Analyze your code through powerful SQL queries. Use tools you're familiar with to create reports and dashboards.
This repository contains the code of source{d} Community Edition (CE) and its project documentation, which you can also see properly rendered at docs.sourced.tech/community-edition.
source{d} CE supports Linux, macOS, and Windows.
To run it you only need:
- To have Docker installed in your PC
- Download
sourced
binary (for your OS) from our releases - Run it:
And log in into http://127.0.0.1:8088 with login:
$ sourced init orgs --token=<github_token> <github_org_name>
admin
, and password:admin
.
If you want more details of each step, you will find in the Quick Start Guide all the steps to get started with source{d} CE, from the installation of its dependencies to running SQL queries to inspect git repositories.
If you want to know more about source{d} CE, in the next steps section you will find some useful resources for guiding your experience using this tool.
If you have any problem running source{d} CE you can take a look at our Frequently Asked Questions or Troubleshooting sections. You can also ask for help when using source{d} CE in our source{d} Forum. If you spotted a bug, or you have a feature request, please open an issue to let us know about it.
For more details on the architecture of this project, read docs/learn-more/architecture.md.
source{d} CE is deployed as Docker containers, using Docker Compose.
This tool is a wrapper for Docker Compose to manage the compose files and its containers easily. Moreover, sourced
does not require a local installation of Docker Compose, if it is not found it will be deployed inside a container.
The main entry point of source{d} CE is sourced-ui, the web interface from where you can access your data, create dashboards, run queries...
The data exposed by the web interface is prepared and processed by the following services:
- babelfish: universal code parser.
- gitcollector: fetches the git repositories owned by your organization.
- ghsync: fetches metadata from GitHub (users, pull requests, issues...).
- gitbase: SQL database interface to Git repositories.
Contributions are welcome and very much appreciated 🙌 Please refer to our Contribution Guide for more details.
source{d} has an amazing community of developers and contributors who are interested in Code As Data and/or Machine Learning on Code. Please join us! 👋
All activities under source{d} projects are governed by the source{d} code of conduct.
GPL v3.0, see LICENSE.