diff --git a/README.md b/README.md
index 8de6b23c2ac39eef0b53138641f80dc85c71db40..10206753c1f00420a9925fa21c160da5ba047168 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,33 @@
 # Catwalk
 
-Database for _Crush_ compatible models
+<img width="297" height="250" alt="catwalk-header" src="https://github.com/user-attachments/assets/8fa4e312-97f1-43dc-899e-1dc0518be5dd" />
+
+<img alt="Catwalk" src="https://user-images.githubusercontent.com/25087/219742757-c8afe0d9-608a-4845-a555-ef59c0af9ebc.png" width="359" />
+
+A database for [_Crush_](https://github.com/charmbracelet/crush) compatible models.
+
+Is there a provider you’d like to see in Crush? Is there an existing model that needs an update? This is a community-supported project and we welcome and encourge contributions.
+
+## Whatcha think?
+
+We’d love to hear your thoughts on this project. Need help? We gotchu. You can find us on:
+
+- [Twitter](https://twitter.com/charmcli)
+- [Discord][discord]
+- [Slack](https://charm.land/slack)
+- [The Fediverse](https://mastodon.social/@charmcli)
+
+[discord]: https://charm.land/discord
+
+## License
+
+[MIT](https://github.com/charmbracelet/catwalk/raw/main/LICENSE)
+
+---
+
+Part of [Charm](https://charm.land).
+
+<a href="https://charm.land/"><img alt="The Charm logo" width="400" src="https://stuff.charm.sh/charm-banner-next.jpg" /></a>
+
+<!--prettier-ignore-->
+Charm热爱开源 • Charm loves open source