Skip to content

Commit

Permalink
Update the readme!
Browse files Browse the repository at this point in the history
  • Loading branch information
deepattic committed Dec 1, 2024
1 parent 28355be commit 905fba2
Showing 1 changed file with 67 additions and 9 deletions.
76 changes: 67 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,69 @@
# wardenpy
cli python password manager
<div align="center">
<hr />

## First iteration
thinking that only one user would use the tool
# WardenPy

[] - Fix the autentication logic
[] - add migration logic to main inti logic
[] - fix todo and warning notations
[] - fix funtions return type to optimize the thing
[] - add colors for all the funtions
[![codecov](https://codecov.io/github/deepattic/wardenpy/graph/badge.svg?token=U6U8SOJUNW)](https://codecov.io/github/deepattic/wardenpy)
[![License](https://img.shields.io/github/license/deepattic/wardenpy)](https://github.com/deepattic/wardenpy/blob/main/LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/deepattic/wardenpy)](https://github.com/deepattic/wardenpy/stargazers)
[![GitHub issues](https://img.shields.io/github/issues/deepattic/wardenpy)](https://github.com/deepattic/wardenpy/issues)
[![GitHub release](https://img.shields.io/github/v/release/deepattic/wardenpy)](https://github.com/deepattic/wardenpy/releases)

wardenpy is a **cli-password manager**, inspired by bitwarden and 1pass.

It uses the most modern and up-to-date hashing algorithms, such as argon 2, and encryption techniques, such as ChaCha20-Poly1305.

| [Getting started](#getting-started)
[Installation](#installation) |

</div>

## Getting started

![Tutorial][tutorial]

Run With python :
```sh
wardenpy init [username] # Set up a SQLite database and create a new user named {username}.
wardenpy -u [username] # Login with your username
wardenpy -u [*] -p [password] # Login with your username and password.

wardenpy export # Export all the entries of a user

```
## Installation

wardenpy can be installed in these easy steps:

1. **Manual Installation**

wardenpy runs on most major platforms.

<details>
<summary>Linux / WSL</summary>

> Just clone the repo and install the requirements:
>
> ```sh
> git clone --depth=1 https://www.github.com/deepattic/wardenpy
> cd wardenpy
> pip install -r requirements.txt
> ```
</details>
<details>
<summary>macOS</summary>
> I just dont have an apple device if you have one plz consider putting a pull request :)
</details>
<details>
<summary>Windows</summary>
> And i also dont have a windows pc if you have one plz consider putting a pull request :/
</details>
[tutorial]: contrib/tutorial.webp

0 comments on commit 905fba2

Please sign in to comment.