You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Once you feed [Sourcerer](https://sourcerer.io/) some git repos, you will get a beautiful profile that will help you learn things about yourself, connect to others, and become a better
22
-
engineer.
23
-
24
-
Example profiles:<br>
25
-
<https://sourcerer.io/sergey><br>
26
-
<https://sourcerer.io/ddeveloperr><br>
27
-
<https://sourcerer.io/wanghuaili><br>
28
-
<https://sourcerer.io/adnanrahic><br>
29
-
30
-
Both open source and closed source repos are fine. The easiest way to get started is with your open source repos. Go to <https://sourcerer.io/start>, and select *Build with GitHub* and watch your profile build. For closed source repos, you will need to use this app. If you already created an account using GitHub, you would have received an email with credentials for the app. If not, You will need a new account, which you can get at <https://sourcerer.io/start>, and select *Build with app*.
The Sourcerer app does **NOT** upload source code anywhere, and it **NEVER** will. The app looks at repos locally on your machine, and then sends stats to sourcerer.io. The best way to verify is to look at the code. [src/main/proto/sourcerer.proto](https://github.com/sourcerer-io/sourcerer-app/blob/develop/src/main/proto/sourcerer.proto)
33
-
is a good start as it describes the client-server protocol.
18
+
Features
19
+
========
20
+
* Profile creation with a single click
21
+
* Support of 100 languages (even exotic ones like COBOL)
22
+
* Detection of more than [1,000 libraries](https://github.com/sourcerer-io/awesome-libraries) in code with per-line statistics
23
+
* Visual presentation your development experience
24
+
**Finally!* Summary of all repositories you've contributed to :tada:
25
+
* Interesting facts about yourself
34
26
35
27
Creating your profile is just the first step for us at Sourcerer. Some of the things on our roadmap include:
36
-
* News that is relevant to your code
37
28
* Engineers to follow and learn from
38
29
* Technology and libraries you should know about
39
30
* Projects that could use your help
40
31
32
+
Get started
33
+
===========
34
+
The easiest way to get started is with your open source repos. Go to [sourcerer.io/start](https://sourcerer.io/start), and select *Build with GitHub* and watch your profile build.
35
+
36
+
For closed source repos, you will need to use this app. If you already created an account using GitHub, you would have received an email with credentials for the app. If not, You will need a new account, which you can get at [sourcerer.io/join](https://sourcerer.io/join>).
* Java 8+ Platform ([JRE](http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html) for Linux or [JDK](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) for macOS)
47
-
* Git repositories with master branch with at least one commit
48
-
* Account on <https://sourcerer.io/>
61
+
or
49
62
50
-
Install/uninstall
51
-
=================
63
+
* Linux or macOS or Windows
64
+
* Java 8+ Platform ([JRE](http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html) for Linux and Windows or [JDK](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) for macOS)
52
65
66
+
Usage
67
+
=====
53
68
To install sourcerer run the following command:
54
69
55
70
```
56
71
curl -s https://sourcerer.io/app/install | bash
57
72
```
58
73
59
-
To remove sourcerer from your machine:
74
+
To run wizard use `sourcerer` command
60
75
61
-
```
62
-
sourcerer --uninstall
63
-
```
76
+
Internals
77
+
=========
78
+
The app looks at repos locally on your machine, and then sends stats to sourcerer.io. The best way to verify is to look at the code. Protobuf messages declared in [src/main/proto/sourcerer.proto](https://github.com/sourcerer-io/sourcerer-app/blob/develop/src/main/proto/sourcerer.proto) is a good start as it describes the client-server protocol.
79
+
The Sourcerer app does **NOT** upload source code anywhere, and it **NEVER** will.
80
+
81
+
FAQ
82
+
===
83
+
### How can I process private repos?
84
+
We process only public repos using GitHub OAuth. To process private repos you need to run sourcerer app locally. See [Get started](#get-started) for instructions. Sourcerer app sends only statistical information to our servers and never sends code.
85
+
86
+
### Why do you need GitHub permissions?
87
+
We use emails to identify commit authorship, read orgs access to get list of public repositories that you've contributed to. You also need to grant access to read this public information from an organization.
88
+
89
+
### Other questions
90
+
See [sourcerer.io/faq](https://sourcerer.io/faq).
91
+
92
+
Contributing
93
+
============
94
+
We love contributions! Check out the [Contribution guide](https://github.com/sourcerer-io/sourcerer-app/blob/master/CONTRIBUTING.md) for more information. Simplest and really helpfull for the community would be contribution meta information to our [supported libraries list](https://github.com/sourcerer-io/awesome-libraries). If you an author of a library you show definitely add yours to the list or you can help to someone whose work you use.
64
95
65
96
Build
66
97
=====
67
-
68
-
To build and run this application, you'll need latest versions of Git, Gradle and JDK installed on your computer. From your command line:
98
+
To build and run this application locally, you'll need latest versions of Git, Gradle and JDK installed on your computer. From your command line:
We love contributions! Check out the [Contribution guide](https://github.com/sourcerer-io/sourcerer-app/blob/master/CONTRIBUTING.md) for more information.
114
+
License
115
+
=======
116
+
Sourcerer is under the MIT license. See the [LICENSE](https://github.com/sourcerer-io/sourcerer-app/blob/develop/LICENSE.md) for more information.
88
117
89
-
Some handy links:<br>
118
+
Links
119
+
=====
90
120
*[Sourcerer Site](https://sourcerer.io/)
91
121
*[Sourcerer Blog](https://blog.sourcerer.io)
92
122
*[Follow Sourcerer on Twitter](https://twitter.com/sourcerer_io)
93
123
*[Follow Sourcerer on Facebook](https://www.facebook.com/sourcerer.io/)
94
-
95
-
License
96
-
=======
97
-
Sourcerer is under the MIT license. See the [LICENSE](https://github.com/sourcerer-io/sourcerer-app/blob/develop/LICENSE.md) for more information.
0 commit comments