Metadata-Version: 2.4
Name: mygeeky
Version: 0.29.0
Summary: Find friends, collaborate, away from noise: your corner of GitHub for research. The people, projects, papers and pulse of your field, from your CV, repos and papers. Suggests only; never follows anyone for you.
Maintainer-email: myGeeKy <support@mygeeky.org>
License: MIT
Project-URL: Homepage, https://mygeeky.org
Project-URL: Source, https://github.com/mygeeky/myGeeKy
Project-URL: Documentation, https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md
Project-URL: Ideas, https://github.com/mygeeky/myGeeKy-ideas
Project-URL: Issues, https://github.com/mygeeky/myGeeKy/issues
Keywords: github,networking,recommendation,cli,ai-agent-tool,developer-tools
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31
Requires-Dist: click>=8.1
Requires-Dist: keyring>=24.0
Requires-Dist: platformdirs>=4.0
Requires-Dist: scikit-learn>=1.3
Requires-Dist: numpy>=1.24
Requires-Dist: pypdf>=4.0
Requires-Dist: cryptography>=42
Requires-Dist: qrcode>=7.4
Requires-Dist: truststore>=0.9; python_version >= "3.10"
Provides-Extra: pdf
Provides-Extra: gui
Provides-Extra: dev
Requires-Dist: pytest>=7.4; extra == "dev"
Dynamic: license-file

<p align="center">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/logo.png" width="120" alt="The myGeeKy badge: the name inside a ring of two arms hugging">
</p>

<h1 align="center">myGeeKy</h1>

<p align="center"><b>Your geeky friend who helps you grow, quietly.</b></p>

<p align="center">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/geekoc/geekoc-grows.svg" width="660" alt="GeekOc, the myGeeKy octopus, watching a plant grow skills, knowledge, collaboration and opportunity, safe under glass">
</p>

<p align="center">
  <a href="https://github.com/mygeeky/myGeeKy/releases/latest"><img alt="Download for Windows" src="https://img.shields.io/badge/%E2%AC%87%20Download%20for%20Windows-MyGeeKySetup.exe-ff6fd8?style=for-the-badge&logo=windows&logoColor=white" height="38"></a>
  <a href="https://pypi.org/project/mygeeky/"><img alt="pip install mygeeky" src="https://img.shields.io/badge/macOS%20%C2%B7%20Linux%20%C2%B7%20Windows-pip%20install%20mygeeky-7a5cff?style=for-the-badge&logo=python&logoColor=white" height="38"></a>
  <a href="https://youtu.be/u1qmX5PtMdE"><img alt="Watch the video" src="https://img.shields.io/badge/%E2%96%B6%20watch-the%20video-35e0c1?style=for-the-badge" height="38"></a>
</p>

<p align="center">
  <a href="https://pypi.org/project/mygeeky/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/mygeeky?color=7fd8ff&label=pypi&style=flat-square"></a>
  <a href="https://pepy.tech/projects/mygeeky"><img alt="Downloads" src="https://img.shields.io/pepy/dt/mygeeky?color=ff6fd8&label=downloads&style=flat-square"></a>
  <a href="https://github.com/mygeeky/myGeeKy/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-35e0c1?style=flat-square"></a>
  <img alt="Runs on your device" src="https://img.shields.io/badge/runs-on%20your%20device-7a5cff?style=flat-square">
  <img alt="Telemetry: none" src="https://img.shields.io/badge/telemetry-none-35e0c1?style=flat-square">
  <img alt="Acts for you: never" src="https://img.shields.io/badge/acts%20for%20you-never-e5484d?style=flat-square">
</p>

<p align="center">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/tour.gif" width="380" alt="The myGeeKy panel in use: live activity, repos ranked by momentum, people near your work, and a skill road map"><br>
  <sub><b>This is the whole program:</b> one panel beside what you were already doing, every tab one click away.<br>
  No window to manage, no dashboard to log into. Close it and nothing keeps running.</sub>
</p>

<p align="center">
  <a href="https://youtu.be/u1qmX5PtMdE"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/video-play.png" width="640" alt="Watch the myGeeKy video on YouTube: your geeky friend who helps you grow, quietly"></a><br>
  <sub><b>▶ Watch the video</b> (2½ minutes, opens on YouTube)</sub>
</p>

<p align="center">
  <a href="#see">👀 See</a> ·
  <a href="#learn">🌱 Learn</a> ·
  <a href="#meet">👥 Meet</a> ·
  <a href="#catch">🎯 Catch</a> ·
  <a href="#install">🚀 Install</a> ·
  <a href="#never">🔒 Never</a> ·
  <a href="https://mygeeky.org">Website</a> ·
  <a href="https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md">Guide</a>
</p>

---

<a name="see"></a>
## 👀 Helps you see what is moving in your field

> *“I read the twenty sites, so you read one.”*

**Papers** gaining citations fastest and the tools behind them, your field as a **daily market**, **models**
trending on Hugging Face, and **news** from labs, journals and the press: all ranked for *your* keywords, not
for everybody's.

<table>
<tr>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/research.png" width="250" alt="Research"><br><sub><b>Research</b><br>papers, and the tools behind them</sub></td>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/market.png" width="250" alt="Market"><br><sub><b>Market</b><br>what rose and fell since yesterday</sub></td>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/news.png" width="250" alt="News"><br><sub><b>News</b><br>labs, journals and the press</sub></td>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/model.png" width="250" alt="Your model"><br><sub><b>Model</b><br>what it thinks you care about</sub></td>
</tr>
</table>

<details>
<summary><b>More about See</b></summary>
<br>

The **Model** tab shows you exactly what myGeeKy thinks you care about, so you can correct it.

It reads OpenAlex, arXiv, bioRxiv, Hacker News, PyPI, Hugging Face, Product Hunt, ORCID, Google Scholar, and
GitHub. **GitHub is one of them, not the point.**

</details>

---

<a name="learn"></a>
## 🌱 Helps you learn what comes next

> *“You haven't used Nextflow yet, and five repos near your work just did. Shall we start?”*

**Any skill becomes a road map.** *R for data analysis* turns into: R basics → statistics with R → a real
project to rerun → your own work. A level check **skips what you already know**, using your own repos as
evidence.

<table>
<tr>
<td align="center" width="33%">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/grow-skills.png" width="300" alt="Rising skills in your field"><br>
  <sub><b>1. What's rising that you don't have yet</b><br>and why it says so</sub>
</td>
<td align="center" width="33%">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/grow-learn.png" width="300" alt="A skill broken into stages"><br>
  <sub><b>2. Pick one, and it becomes stages</b><br>starting past what you know</sub>
</td>
<td align="center" width="33%">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/grow-protocols.png" width="300" alt="A protocol as a road map"><br>
  <sub><b>3. The road map</b><br>the step you're on makes room for itself</sub>
</td>
</tr>
</table>

<details>
<summary><b>More about Learn</b></summary>
<br>

The level check shows its evidence (*“6 of your repos use R”*), and you can overrule it.

For a skill nobody has written up, a small model **on your machine** (about 400 KB) searches code and papers
and sorts what it finds into stages. **14 protocols are written and reviewed**, from *your first pull request*
to *statistics for experiments: which test, and why*.

<sub>Software, data, statistics, figures and pipelines, <b>never laboratory or bench protocols</b>:
<a href="https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#what-mygeeky-does-not-teach">why</a>.</sub>

</details>

---

<a name="meet"></a>
## 👥 Helps you meet the people working on the same problems

> *“These four work on what you work on, and they tend to follow back.”*

**People near your work**, with how likely each is to follow back, what they **pushed in the last hour**, and
**repos worth your first pull request**. **You follow, star and message by hand, always.** myGeeKy introduces;
it never acts for you.

<table>
<tr>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/suggestions.png" width="250" alt="People"><br><sub><b>People</b><br>near your work, and likely to follow back</sub></td>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/live.png" width="250" alt="Live"><br><sub><b>Live</b><br>who moved in the last hour</sub></td>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/repos.png" width="250" alt="Repos"><br><sub><b>Repos</b><br>where your pull request has a chance</sub></td>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/signals.png" width="250" alt="Signals"><br><sub><b>Signals</b><br>a quiet room, if you want one</sub></td>
</tr>
</table>

<details>
<summary><b>More about Meet</b></summary>
<br>

Repos are ranked by whether the maintainers actually merge outside work. **Signals** is a quiet room for the
people who opted into one.

There is also a private 🙏 *thank you*: **only the person you send it to can read it.** No public counter, no
leaderboard, nothing for anyone else to see.

</details>

---

<a name="catch"></a>
## 🎯 Helps you catch the opportunities while they are still open

> *“Two deadlines this week. Both still open; I checked the page myself.”*

**Jobs, funding, conferences and the scholarships that come back every year.** Each one is **checked against
its own page** before you see it, sorted by **deadline**, and **gone the moment it passes**.

<table>
<tr>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/chances-seasons.png" width="250" alt="Seasons: a scholarship that comes back every year, with the weeks of preparation it needs"><br><sub><b>Seasons</b><br>months of warning, and what to prepare</sub></td>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/chances-jobs.png" width="250" alt="Jobs"><br><sub><b>Jobs</b><br>deadline first</sub></td>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/chances-funding.png" width="250" alt="Funding"><br><sub><b>Funding</b><br>you can still apply for</sub></td>
<td align="center" width="25%"><img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/chances-conferences.png" width="250" alt="Conferences"><br><sub><b>Conferences</b><br>before the abstract closes</sub></td>
</tr>
</table>

<details>
<summary><b>More about Catch, and 🗓 Seasons</b></summary>
<br>

The board is never a list of things you are already too late for. A listing written in **Arabic, French,
German, Spanish or Chinese** is read, translated and still checked against its own page, then shown to you in
English. Filter by country, because that applies to all of them.

**Seasons is for the ones that come back every year.** A scholarship does not stop being real when it closes:
it returns next April, and *the preparing takes longer than the applying*. So myGeeKy says *“expected in about
12 weeks”* while there is still time to get transcripts certified and a proposal written, and tells you **how
many years of evidence** stand behind that expectation.

It never pretends to know next year's date: a window it read on a page says **open now**, anything ahead says
**expected**.

</details>

---

<a name="install"></a>
## 🚀 Install

<table>
<tr>
<td width="50%" valign="top">

### 🪟 Windows

1. Download **[MyGeeKySetup.exe](https://github.com/mygeeky/myGeeKy/releases/latest)** (under *Assets*)
2. **Next → Next → Finish**

Nothing needs installing first: it sets up Python and Git for you, no admin rights.

<sub>If Windows says <i>“Windows protected your PC”</i> (not code-signed yet): <b>More info → Run anyway</b>.</sub>

</td>
<td width="50%" valign="top">

### 🐧 Linux · 🍎 macOS · 🐍 anywhere

```bash
curl -fsSL https://mygeeky.org/install.sh | sh
```

or with pip:

```bash
pip install mygeeky
mygeeky setup
```

<sub>Run the one-liner again to update. Macs get <b>myGeeKy.app</b> in Launchpad and Spotlight.</sub>

</td>
</tr>
</table>

<table>
<tr>
<td align="center" width="50%">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/setup-welcome.png" width="420" alt="The setup window, asking what you work on"><br>
  <sub><b>It asks what you work on.</b> That's the whole setup.</sub>
</td>
<td align="center" width="50%">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/setup-finish.png" width="420" alt="The last setup step, done"><br>
  <sub><b>Then it's yours.</b> A GitHub account is optional, and later.</sub>
</td>
</tr>
</table>

**Then just type what you work on.** A GitHub account unlocks who'd follow you back, your activity and
Signals; everything else works without one.

---

## 📱 On your phone

<img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/screenshots/phone/hint.png" width="200" align="right" alt="The myGeeKy phone app: your world in orbit">

**Your world in orbit:** you in the middle, your circle on the inner ring, the world on the outer one.

Spin a ring with your thumb; tap to read and the rings fold into a slim dock. Set it up with one scan from
the desktop panel.

<sub>On Android, coming to Google Play soon.</sub>

<br clear="right">

---

## 🤫 For anyone who works alone

<table>
<tr>
<td width="40%" align="center" valign="middle">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/geekoc/alone.png" width="340" alt="A geek in a hoodie sitting against a brick wall with a laptop on their legs and a myGeeKy sticker on the lid, the background fading away around them">
</td>
<td valign="middle">

*“You might be the only one in your building who does this. You are not the only one in the world.”*

|  |  |
|---|---|
| 🔕 **No noise** | No feed, no likes, no streaks. No notifications unless you switch them on, and then one short summary a day at most. |
| 👋 **Friends, not followers** | People near your work, and how likely each is to answer. |
| 🤝 **Thanks, privately** | A 🙏 only the person you send it to can read. |
| 🚪 **Nobody sees you looking** | No account, no sign-up, no telemetry. There is no server to see you from. |
| 🌙 **It waits** | Close it and nothing keeps running (unless you switched notifications on). It never pings you to come back. |
| 🧰 **Yours to keep** | MIT, and open to read: every promise here is a file you can check. |

</td>
</tr>
</table>

---

<a name="never"></a>
## 🔒 What it will never do

> *“I keep all of this on your computer. I never post for you, and I never tell anyone you were here.”*

|  |  |  |
|:-:|---|---|
| ✋ | **Never acts as you.** | You look, you decide, you act. |
| 🧠 | **Never leaves your machine.** | No server, no account, no telemetry. |
| 🔑 | **Never holds your keys.** | They stay in your system's keyring. |
| 📦 | **Never takes your data.** | It stays on your computer. |
| 📨 | **Never sends anything behind your back.** | You read every report before it goes. |

<details>
<summary><b>The promises in full</b></summary>
<br>

- ✋ **Never acts as you.** It never follows, stars, forks, posts or comments: **there is no code for it
  anywhere in the project.**
- 🧠 **Never leaves your machine.** The model that ranks all of this runs on your computer, because there is
  no server.
- 🔑 **Never holds your keys.** Tokens live in your operating system's keyring, checked for least privilege,
  **never logged and never printed.**
- 📦 **Never takes your data.** It stays on your computer, plus a **private repo you own**, if you want sync.
- 📨 **Never sends anything behind your back.** If it breaks, you read the whole report first, with your name,
  email, tokens and folders already stripped out, and **you** decide whether it goes.

<sub><a href="https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#safety">Safety in full</a> ·
<a href="https://github.com/mygeeky/myGeeKy/blob/main/stability/PROTOCOL.md">how each release is checked</a></sub>

</details>

---

## 📚 Everything else

**[The full guide](https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md)**: every tab,
[the two tokens](https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#install),
[keywords that carry meaning](https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#keywords-that-mean-something-mygeeky-keywords),
[how it learns](https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#it-learns-what-youre-into-and-keeps-room-to-explore),
[Signals](https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#join-signals-step-by-step),
[sync](https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#use-it-from-any-computer-mygeeky-sync),
[macOS](https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#macos),
[scripts and AI agents](https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#using-mygeeky-from-an-ai-agent--script),
[every setting](https://github.com/mygeeky/myGeeKy/blob/main/docs/GUIDE.md#all-parameters-adjustable-or-leave-at-the-defaults).

**An idea, a problem, a question?** Click **💡** in the panel: it opens a ready-to-send issue in
[myGeeKy-ideas](https://github.com/mygeeky/myGeeKy-ideas) that you submit yourself. Or email
**[support@mygeeky.org](mailto:support@mygeeky.org)**.

## License

MIT. Made with ❤️ for researchers who build things at a computer.

<p align="center">
  <img src="https://raw.githubusercontent.com/mygeeky/myGeeKy/main/docs/geekoc/geekoc-swim.png" width="110" alt="GeekOc swimming off"><br>
  <a href="https://github.com/mygeeky/myGeeKy"><img alt="Star myGeeKy on GitHub" src="https://img.shields.io/github/stars/mygeeky/myGeeKy?style=social"></a>
</p>
