diff --git a/README.md b/README.md
new file mode 100644
index 0000000..16375f7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,81 @@
+
+
+ 
+
+
+
+
+
+ 
+
+
+
+
+
Karst
+
+
+Karst is a permissionless and composable social graph built on Starknet, empowering creators to own every part of their social experience.
+
+With Karst, creators no longer need to worry about losing their content, audience, and livelihood based on the whims of an individual platform's algorithms and policies.
+
+## Development Setup
+You will need to have Scarb and Starknet Foundry installed on your system. Refer to the documentations below:
+
+- [Starknet Foundry](https://foundry-rs.github.io/starknet-foundry/index.html)
+- [Scarb](https://docs.swmansion.com/scarb/download.html)
+
+To use this repository, first clone it:
+```
+git clone git@github.com:horuslabsio/karst-core.git
+cd karst-core
+```
+
+### Building contracts
+To build the contracts, run the command:
+```
+scarb build
+```
+
+### Running Tests
+To run the tests contained within the `tests` folder, run the command:
+```
+snforge test
+```
+
+### Formatting contracts
+We use the in-built formatter that comes with Scarb. To format your contracts, simply run the command:
+```
+scarb fmt
+```
+
+For more information on writing and running tests, refer to the [Starknet-Foundry documentation](https://foundry-rs.github.io/starknet-foundry/index.html)
+
+## Architecture
+
+Check out the contract architecture below, and join our [working group](https://t.me/+DFfuHjLkeXlkNTg0).
+
+
+
+
+## Contributing
+
+BEFORE you start work on a feature or fix, please read and follow our [contribution guide](https://github.com/horuslabsio/karst-core/blob/master/CONTRIBUTING.md) to help avoid any wasted or duplicate effort.
+
+## Security
+
+If you believe you have found a security vulnerability in our code, please report it to us as described in our [security policy](https://github.com/horuslabsio/karst-core/blob/master/SECURITY.md).
+
+## License
+
+KARST is an open-source software licensed under the [MIT](https://github.com/horuslabsio/karst-core/blob/master/LICENSE.md).
+
+## Contributors
+
+
+
+
+
+
+
+
+
\ No newline at end of file