baobaxia 0.1.24
Baobáxia is an eventually connected data network

# BAOBÁXIA

__NA ROTA DOS BAOBÁS__

<pre>
                               .
                              ,d              .   ,
                             aA...             YF^
                              *@@@b          d@P
                                *@@@b,,,,,-d@@P   ,     ,
                    ....a@@@@aa.. *@@V@`;;..,,  ,*,   ,*
                     `V*'  ``*@@B`b b@((bb`@@P*q*@@*"'
                               `*@`9@,(()))*'   `*.   
                                `A@,`@@Y@(;'
                                 (a`@,`@`&@
                                ."@,@`.@(@@
                               (@a.@",@^a.,
                               ,.o..o@ (@o.`
                               (*",.`*@@o`*@,         <i>"Vamos fazer um mundo digital</i>
                              ,',@***@a,,`^*.,                       <i>mais do nosso jeito!"</i>
                              ,&^,@@@@@a,`a.,
                              &`@`,;aaaa @; )@        <a href="http://wiki.mocambos.net/wiki/NPDD">NPDD/Rede Mocambos</a>
                              c@(.@".;'".@",@@"
                              @@ @",@`.@*`,@@`,
                              @P,@,*@a, ,a@*`,@
                            , *(`*@@a.,*@*`,@*`
                ,;a&*"` .;a@@ *;,'o,`*@@a;@@P`, oo..,,
        ,.;a@@@*"`  ,;a@@*"` , *"`7`,"a,`"*",d) **oo..`""*oo.,
    ,;@@@@@@*`  ,;d@@@@P` ,.@@b *@b`"@a,`"*@@@` ~*o..,`""*oo,."*@a,
    @@@@@@@@b   `*@@@@@;, `'"*@, "*@@a`*@@&;,` ~*o.,, `"@a, `*@b,`*@a
    `"*@@@@@@b.    `"*o@@@@a;,  `"*o,,`` `""*@@@b;.`"*, `@@   `@@;  `*,
       `"*@@@@@@b.     ``*o@@@@@@;,   `"*ooo**'`  ,;o@*  `@    @@@; 
          `"*@@@@@@@b.,     ``"***oo@@oo;,,,,,;;o@@*'` ,;o@    `@@@@,
             `"*@@@@@@@@@b.,,                       ,;o@@@@     @@@@@ 
                `"*@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@P*    ,@@@@@
                        ````````''''''''''''''''''''```  ,...;@@@@P*`
                                                      ```'"""```
</pre>

Publicado sob [GNU/GPLv3](LICENSE).

## Introdução

>>>
“A ideia nasce da referência do Baobá, árvore que vive milhares 
de anos e representa simbolicamente a memória coletiva ligada ao 
território. Baobáxia é a união de baobá com galáxia. Uma galáxia de 
memórias coletivas locais ligadas ao território. A galáxia liga também 
com as estrelas, que por sua vez são ligadas a Casa de Cultura Tainã, 
que em tupi-guarani significa caminho das estrelas. Baobáxia vira bbx, 
tirando as vocais, que remete ao acrônimo bbs que eram os nos de uma 
antiga rede de computadores.”
>>>

Baobáxia é um sistema de gestão descentralizada de repositórios compartilhados
dentro de uma rede denominada rota, a _Rota dos Baobás_. As instâncias que
controlam os repositórios, denominadas _Mucuas_, que também é o nome do fruto
do Baobá, gerenciam os repositórios a partir de uma API de metadados exposta
como rest, atuando sobre repositórios sincronizados.

São pontos de atenção do projeto a eficácia no compartilhamento de dados em redes
instáveis e de baixa disponibilidade e a eficiência no uso do hardware local
visando facilitar o acesso a equipamentos com potencial de serem Mucuas.


## Apoio

A partir de dezembro de 2019 o projeto conta com apoio da FAPESP atravez do projeto:
**Siwazi Rowaihuuze Auwe - rede de informação Xavante: conectividade, gestão de dados 
e apropriação da internet por povos indígenas**.

Processo: 18/23094-4 


## Características da versão

# Instalar

## Instalação com docker

Criar a imagem com dados padrões da Casa de Cultura Tainã:

```
sudo docker build -t bbx-fastapi .
```

Criar a imagem com dados personalizados:

```
sudo docker build -t bbx-fastapi \
    --build-arg BALAIO='Nosso Balaio' \
    --build-arg EMAIL='a-gente@email.net' \
    --build-arg MOCAMBO='Comunidade' \
    --build-arg MOCAMBOLA='mocambola' \
    --build-arg MUCUA='Itinerante' \
    --build-arg SENHA='tem que trocar' .
```

e iniciar com

```
sudo docker run --name xango1 -p 80:80 bbx-fastapi
```

Pronto, agora você já tem a API de Baobáxia rodando e possui uma mucua criada.

---

## Instalação com virtualenv e pip

Criar um virtualenv com 
```
virtualenv nomevirtualenv
```

Ativar o ambiente com
```
. /caminho/para/nomevirtualenv/bin/activate
```

Para instalar digite:

```
pip install baobaxia
```

# Criar uma mucua e um balaio

Depois de instalar o software do Baobáxia, precisa criar uma mucua e um balaio
usando o comando *criar_mucua*, por exemplo:

```
criar_mucua --path='/data/bbx/balaios' --balaio='Rede Mocambos Acervo' \
--mucua='Abdias Nascimento' --mocambo='Casa de Cultura Tainã' \
--mocambola='mocambola' --email='mocambola@mocambos.net' --password='livre' \
--smid_len=13 --slug_name_len=21 --slug_smid_len=5 --slug_sep "_"
```

Pode ver as opções chamando com opção --help.

Em seguida para rodar a API da aplicação *acervo*:

```
uvicorn baobaxia.acervo:api --host 0.0.0.0 --port 80
```