discovered 30 Mar 2026

iKy

Python ★ 942 via github-topic

AI Summary: iKy is a cybersecurity tool designed to collect and display information related to email addresses through an intuitive visual interface. It integrates multiple modules such as FullContact, LinkedIn, and HaveIBeenPwned, allowing users to gather diverse data points about email owners, enhancing the reconnaissance process in cybersecurity investigations. The tool leverages technologies like Flask for the interface, Redis for storage, and is deployable via Docker, ensuring robust performance and ease of use.

README

iKy

Description

Project iKy is a tool that collects information from an email and shows results in a nice visual interface.

Visit the Gitlab Page of the Project

Video Demo

Modules

Installation

Prerequisites

Docker
Docker Compose (included with Docker Desktop)
(Optional) just task runner

Quick start

git clone https://gitlab.com/kennbroorg/iKy.git
cd iKy
docker compose build
docker compose up -d

Or, if you have just installed:

just build
just up

Open your browser at http://localhost:4200

To stop all services:

docker compose down
# or
just down

Development

The development workflow uses a virtualenv for linting/pre-commit hooks and Docker for building and running the application.

Setting up the dev environment

Install just, then:

just setup
source .venv/bin/activate

This creates a Python virtualenv with pre-commit and ruff, and installs the git hooks.

Common recipes

Command	Description
`just build`	Build Docker images
`just up`	Start all services
`just down`	Stop all services
`just logs`	Follow backend logs (`just logs frontend` for frontend)
`just ps`	Show running containers
`just shell-backend`	Open a shell in the backend container
`just shell-frontend`	Open a shell in the frontend container
`just lint`	Run ruff linter and format check
`just fmt`	Auto-format Python code
`just restart backend`	Restart a specific service
`just rebuild`	Stop, rebuild, and start all services
`just clean`	Remove containers, volumes, and local images

API Keys

Once the application is loaded in the browser, it should get most of the APIs and/or session cookies from the browser. Below is a table with all the fields to fill out

Module	Status	Field in apikey	Description
Fullcontact	:octagonal_sign:		Discontinued
PeopleDataLabs	:ok:	peopledatalabs_key	:free: API Free. Explained here
Linkedin	:ok:	linkedin_li_at / linkedin_JSESSIONID (***)	:free: Cookie browser(:cookie:) method. Explained here
Twitter	:ok:	twitter_user / twitter_pass (***)	:free: Cookie browser(:cookie:) or user/pass. Explained here
Instagram	:ok:	instagram_user / instagram_pass (***)	:free: Cookie browser(:cookie:) or user/pass. Explained here
HaveIBeenPwned	:ok:	haveibeenpwned_key	:heavy_dollar_sign: API Paid. Explained here
Emailrep	:ok:	emailrep_key	:free: API Free. Explained here
Leaklookup	:ok:	leaklookup_key	:free: API Free. Explained here
Spotify	:ok:	spotify_client_id / spotify_client_secret	:free: API Free. Explained here
Twitch	:ok:	twitch_client_id / twitch_client_secret	:free: API Free. Explained here
CSE (Google)	:ok:	cse_api_key / cse_cx	:free: API Free. Explained here
Reddit	:warning:		In revision
Tiktok	:ok:		Get from your preferred browser. Just log in with your user

Update iKy

Pull the latest changes and rebuild the Docker images:

git pull
docker compose build
docker compose up -d

Or with just:

git pull
just rebuild

To preserve your API keys across updates, use the Export/Import options in the apikeys menu of the graphical interface.

Wiki

iKy Wiki

Demo Video

Vimeo

Whether you use this project, have learned something from it, or just like it, please consider supporting it by buying me a coffee, so I can dedicate more time on open-source projects like this.

Disclaimer

Anyone who contributes or contributed to the project, including me, is not responsible for the use of the tool (Neither the legal use nor the illegal use, nor the “other” use).

Keep in mind that this software was initially written for a joke, then for educational purposes (to educate ourselves), and now the goal is to collaborate with the community making quality free software, and while the quality is not excellent (sometimes not even good) we strive to pursue excellence.

Consider that all the information collected is free and available online, the tool only tries to discover, collect and display it. Many times the tool cannot even achieve its goal of discovery and collection. Please load the necessary APIs before remembering my mother. If even with the APIs it doesn’t show “nice” things that you expect to see, try other e-mails before you remember my mother. If you still do not see the “nice” things you expect to see, you can create an issue, contact us by e-mail or by any of the RRSS, but keep in mind that my mother is neither the creator nor Contribute to the project.

We do not refund your money if you are not satisfied. I hope you enjoy using the tool as much as we enjoy doing it. The effort was and is enormous (Time, knowledge, coding, tests, reviews, etc.) but we would do it again. Do not use the tool if you cannot read the instructions and / or this disclaimer clearly.

By the way, for those who insist on remembering my mother, she died many years ago but I love her as if she were right here.

osint python

iKy