···

       
1
       
1
       
 
       
microcosm

     

       
2
       
2
       
 
       
=========

     

       
3
       
3
       
 
       


     

       
4
       
4
       
-
       
HTTP APIs and rust libraries for [atproto](https://atproto.com/) services from [microcosm](https://microcosm.blue).

     

       
5
       
5
       
-
       


     

       
6
       
4
       
 
       
[![@microcosm.blue: bluesky](https://img.shields.io/badge/@microcosm.blue-bluesky-blue)](https://bsky.app/profile/microcosm.blue)

     

       
7
       
5
       
 
       
[![microcosm discord: join](https://img.shields.io/badge/microcosm_discord-join-purple)](https://discord.gg/tcDfe4PGVB)

     

       
8
       
6
       
 
       
[![github sponsors: support](https://img.shields.io/badge/github_sponsors-support-pink)](https://github.com/sponsors/uniphil/)

     

       
9
       
7
       
 
       
[![ko-fi: support](https://img.shields.io/badge/ko--fi-support-pink)](https://ko-fi.com/bad_example)

     

       
10
       
8
       
 
       


     

       
11
       
11
       
-
       
Welcome!

     

       
9
       
9
       
+
       
Welcome! Here you'll find HTTP APIs and rust libraries for [atproto](https://atproto.com/) services from [microcosm](https://microcosm.blue).

     

       
12
       
10
       
 
       


     

       
13
       
13
       
-
       
The documentation for microcosm services is under active development. If you like reading API docs, you'll probably hit the ground running!

     

       
11
       
11
       
+
       
Documentation is under active development. If you like reading API docs, you'll probably hit the ground running!

     

       
14
       
12
       
 
       


     

       
15
       
15
       
-
       
Tutorials, how-to guides, and client SDK libraries are all in the works for gentler on-ramps, but are not quite ready yet. But don't let that stop you! Hop in the [microcosm discord](https://img.shields.io/badge/microcosm_discord-join-purple), or post questions and tag [@bad-example.com](https://bsky.app/profile/bad-example.com) on Bluesky if you get stuck anywhere!

     

       
13
       
13
       
+
       
Tutorials, how-to guides, and client SDK libraries are all in the works for gentler on-ramps, but are not quite ready yet. But don't let that stop you! Hop in the [microcosm discord](https://discord.gg/tcDfe4PGVB), or post questions and tag [@bad-example.com](https://bsky.app/profile/bad-example.com) on Bluesky if you get stuck anywhere.

     

       
16
       
14
       
 
       


     

       
17
       
17
       
-
       
This repository's primary home is moving to tangled: [@microcosm.blue/microcosm-rs](https://tangled.sh/@microcosm.blue/microcosm-rs). It will continue to be mirrored on [github](https://github.com/at-microcosm/microcosm-rs) for the forseeable future, and it's fine to open issues or pulls in either place!

     

       
15
       
15
       
+
       
> [!tip]

     

       
16
       
16
       
+
       
> This repository's primary home is moving to tangled: [@microcosm.blue/microcosm-rs](https://tangled.sh/@microcosm.blue/microcosm-rs). It will continue to be mirrored on [github](https://github.com/at-microcosm/microcosm-rs) for the forseeable future, and it's fine to open issues or pulls in either place!

     

       
18
       
17
       
 
       


     

       
19
       
18
       
 
       


     

       
20
       
19
       
 
       
🌌 [Constellation](./constellation/)

     
···

       
61
       
60
       
 
       
- [Public instance/API docs](https://ufos-api.microcosm.blue/)

     

       
62
       
61
       
 
       
- Status: Used in production. It has APIs and they work! Needs improvement on indexing; needs more indexes and some more APIs to the data exposed.

     

       
63
       
62
       
 
       


     

       
64
       
64
       
-
       
> [!info]

     

       
63
       
63
       
+
       
> [!tip]

     

       
65
       
64
       
 
       
>  See also: [UFOs atproto explorer](https://ufos.microcosm.blue/) built on UFOs API. ([source](github.com/at-microcosm/spacedust-utils))

     

       
66
       
65
       
 
       


     

       
67
       
66
       
 
       


     
···

       
82
       
81
       
 
       
- Source: [./links/](./links/)

     

       
83
       
82
       
 
       
- Status: used in multiple apps in production, but not yet published to crates.io; some rework planned

     

       
84
       
83
       
 
       


     

       
85
       
85
       
-
       
> [!info]

     

       
84
       
84
       
+
       
> [!tip]

     

       
86
       
85
       
 
       
> See also: [Rocketman](https://github.com/teal-fm/cadet/tree/main/rocketman), another excellent rust jetstream client which shares some lineage and _is_ published on crates.io.

     

       
87
       
86
       
 
       


     

       
88
       
87
       
 
       


     
···

       
96
       
95
       
 
       
- Status: ready for retirement.

     

       
97
       
96
       
 
       


     

       
98
       
97
       
 
       
> [!warning]

     

       
99
       
99
       
-
       
> Still in use for the Spacedust Notifications demo, but that will hopefully be migrated to use atproto oauth directly instead.

     

       
98
       
98
       
+
       
> `who-am-i` is still in use for the Spacedust Notifications demo, but that will hopefully be migrated to use atproto oauth directly instead.